galet 0.1.0__tar.gz

galet-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 junwin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

galet-0.1.0/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: galet
+Version: 0.1.0
+Summary: Provider-agnostic LLM, embedding, and image generation stack extracted from the Lucy monorepo
+Author-email: junwin <jdunwin@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/junwin/galet
+Project-URL: Repository, https://github.com/junwin/galet
+Keywords: llm,openai,gemini,mistral,deepseek,ollama,embeddings,image-generation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: openai
+Provides-Extra: openai
+Requires-Dist: openai; extra == "openai"
+Provides-Extra: gemini
+Requires-Dist: google-genai; extra == "gemini"
+Dynamic: license-file
+
+# galet
+
+Provider-agnostic LLM, embedding, and image generation stack.
+
+## Lineage
+
+This package is extracted from the Lucy monorepo (`src/llm` in
+`/home/junwin/src/repos/lucy`) as described in
+`software/ai/lucy/design/llm-module-extraction.md`.
+
+It is a fresh repository with no shared git history. The extracted module's
+behaviour, public interface, optional-SDK import fallbacks, and
+no-fail-on-missing-credential semantics are preserved as-is; the only
+intentional change is the configuration boundary (see `settings.py` in later
+checkpoints).
+
+## Status
+
+Scaffold only. The `src/llm` modules and their tests are moved into this
+package in subsequent checkpoints.
+
+## Configuration
+
+galet needs two pieces of configuration, and both can be set with an
+environment variable or a command-line flag.
+
+### Credentials (API keys)
+
+Only non-Ollama providers need an API key. galet resolves a key in this order:
+
+1. The provider's own environment variable (`OPENAI_API_KEY`,
+   `DEEPSEEK_API_KEY`, `GEMINI_API_KEY`, `MISTRAL_API_KEY`).
+2. A credential file in the directory named by `--credential-path`, or the
+   `GALET_CREDENTIAL_PATH` environment variable when no flag is given.
+
+Credential file names:
+
+| Provider  | File                | Key(s) in the file            |
+|-----------|---------------------|-------------------------------|
+| openai    | `oaicred.json`      | `openai_api_key`              |
+| deepseek  | `deepseek_cred.json`| `deepseek_api_key`            |
+| gemini    | `gemini_cred.json`  | `gemini_api_key`, `api_key`   |
+| mistral   | `mistral_cred.json` | `mistral_api_key`             |
+
+Example credential file (`oaicred.json`):
+
+```json
+{"openai_api_key": "sk-..."}
+```
+
+```bash
+python samples/send_request.py --credential-path /path/to/credentials --provider openai "hi"
+GALET_CREDENTIAL_PATH=/path/to/credentials python samples/send_request.py --provider openai "hi"
+```
+
+### Ollama base URL
+
+Ollama needs no API key, but galet must know where the Ollama server is. galet
+resolves the address in this order:
+
+1. `--ollama-base-url` (command-line flag)
+2. `OLLAMA_BASE_URL` (environment variable)
+3. `http://localhost:11434/v1` (default, Ollama's OpenAI-compatible endpoint)
+
+```bash
+# Default local Ollama
+python samples/send_request.py --provider ollama "hi"
+
+# Explicit URL
+python samples/send_request.py --provider ollama --ollama-base-url http://localhost:11434/v1 "hi"
+
+# Environment variable
+OLLAMA_BASE_URL=http://192.168.87.40:11434/v1 python samples/send_request.py --provider ollama "hi"
+```
+
+Note the `/v1` suffix: galet talks to Ollama's OpenAI-compatible endpoint, not
+the native Ollama API.

galet-0.1.0/README.md

@@ -0,0 +1,77 @@
+# galet
+
+Provider-agnostic LLM, embedding, and image generation stack.
+
+## Lineage
+
+This package is extracted from the Lucy monorepo (`src/llm` in
+`/home/junwin/src/repos/lucy`) as described in
+`software/ai/lucy/design/llm-module-extraction.md`.
+
+It is a fresh repository with no shared git history. The extracted module's
+behaviour, public interface, optional-SDK import fallbacks, and
+no-fail-on-missing-credential semantics are preserved as-is; the only
+intentional change is the configuration boundary (see `settings.py` in later
+checkpoints).
+
+## Status
+
+Scaffold only. The `src/llm` modules and their tests are moved into this
+package in subsequent checkpoints.
+
+## Configuration
+
+galet needs two pieces of configuration, and both can be set with an
+environment variable or a command-line flag.
+
+### Credentials (API keys)
+
+Only non-Ollama providers need an API key. galet resolves a key in this order:
+
+1. The provider's own environment variable (`OPENAI_API_KEY`,
+   `DEEPSEEK_API_KEY`, `GEMINI_API_KEY`, `MISTRAL_API_KEY`).
+2. A credential file in the directory named by `--credential-path`, or the
+   `GALET_CREDENTIAL_PATH` environment variable when no flag is given.
+
+Credential file names:
+
+| Provider  | File                | Key(s) in the file            |
+|-----------|---------------------|-------------------------------|
+| openai    | `oaicred.json`      | `openai_api_key`              |
+| deepseek  | `deepseek_cred.json`| `deepseek_api_key`            |
+| gemini    | `gemini_cred.json`  | `gemini_api_key`, `api_key`   |
+| mistral   | `mistral_cred.json` | `mistral_api_key`             |
+
+Example credential file (`oaicred.json`):
+
+```json
+{"openai_api_key": "sk-..."}
+```
+
+```bash
+python samples/send_request.py --credential-path /path/to/credentials --provider openai "hi"
+GALET_CREDENTIAL_PATH=/path/to/credentials python samples/send_request.py --provider openai "hi"
+```
+
+### Ollama base URL
+
+Ollama needs no API key, but galet must know where the Ollama server is. galet
+resolves the address in this order:
+
+1. `--ollama-base-url` (command-line flag)
+2. `OLLAMA_BASE_URL` (environment variable)
+3. `http://localhost:11434/v1` (default, Ollama's OpenAI-compatible endpoint)
+
+```bash
+# Default local Ollama
+python samples/send_request.py --provider ollama "hi"
+
+# Explicit URL
+python samples/send_request.py --provider ollama --ollama-base-url http://localhost:11434/v1 "hi"
+
+# Environment variable
+OLLAMA_BASE_URL=http://192.168.87.40:11434/v1 python samples/send_request.py --provider ollama "hi"
+```
+
+Note the `/v1` suffix: galet talks to Ollama's OpenAI-compatible endpoint, not
+the native Ollama API.

galet-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "galet"
+version = "0.1.0"
+description = "Provider-agnostic LLM, embedding, and image generation stack extracted from the Lucy monorepo"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+authors = [{ name = "junwin", email = "jdunwin@gmail.com" }]
+keywords = ["llm", "openai", "gemini", "mistral", "deepseek", "ollama", "embeddings", "image-generation"]
+dependencies = ["openai"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries",
+]
+
+[project.optional-dependencies]
+openai = ["openai"]
+gemini = ["google-genai"]
+
+[project.urls]
+Homepage = "https://github.com/junwin/galet"
+Repository = "https://github.com/junwin/galet"
+
+[tool.setuptools.packages.find]
+where = ["src"]

galet-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

galet-0.1.0/src/galet/__init__.py

@@ -0,0 +1,43 @@
+from .dto import LLMResponse, LLMUsage, ToolCall
+from .interface import LLMApi
+from .adapter_interface import LLMAdapter
+
+try:
+    from .openai_responses import OpenAIResponsesApi
+    from .openai_responses_adapter import OpenAIResponsesAdapter
+except Exception:
+    # openai and related adapters are optional for test environments; avoid
+    # failing import when the 'openai' package is not installed.
+    OpenAIResponsesApi = None
+    OpenAIResponsesAdapter = None
+
+try:
+    from .mistral_api import MistralApi
+    from .mistral_responses_adapter import MistralResponsesAdapter
+except Exception:
+    MistralApi = None
+    MistralResponsesAdapter = None
+
+try:
+    from .ollama_api import OllamaApi
+except Exception:
+    OllamaApi = None
+
+try:
+    from .gemini_api import GeminiApi
+except Exception:
+    GeminiApi = None
+
+__all__ = [
+    "LLMApi",
+    "LLMAdapter",
+    "LLMResponse",
+    "LLMUsage",
+    "ToolCall",
+    "OpenAIResponsesApi",
+    "OpenAIResponsesAdapter",
+    "MistralApi",
+    "MistralResponsesAdapter",
+    "OllamaApi",
+    "GeminiApi",
+]

galet-0.1.0/src/galet/adapter_interface.py

@@ -0,0 +1,53 @@
+from __future__ import annotations
+
+from typing import Any, Dict, List, Optional, Protocol
+
+from .dto import LLMUsage
+
+
+class LLMAdapter(Protocol):
+    """Protocol glue between the FunctionCallingProcessor and a specific LLM API.
+
+    The processor should remain LLM-agnostic. The adapter is responsible for:
+    - calling the model
+    - extracting tool calls in a normalized shape
+    - formatting tool outputs in the model's expected protocol
+
+    For now, we keep messages and tool definitions OpenAI-shaped.
+    """
+
+    def supports_image_processing(self, model: str, provider: Optional[str] = None) -> bool:
+        """Return True if the selected model can natively process images."""
+        ...
+
+    def call_model(
+        self,
+        *,
+        model: str,
+        input: Any,
+        temperature: Optional[float] = None,
+        tools: Optional[List[Dict[str, Any]]] = None,
+        tool_choice: Optional[str] = None,
+        store: Optional[bool] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+        previous_response_id: Optional[str] = None,
+        text: Optional[Dict[str, Any]] = None,
+        provider: Optional[str] = None,
+    ) -> Any: ...
+
+    def extract_tool_calls(self, response: Any) -> List[Dict[str, Any]]: ...
+
+    def format_tool_output(
+        self,
+        *,
+        call_id: str,
+        output: str,
+        name: Optional[str] = None,
+        provider: Optional[str] = None,
+    ) -> Dict[str, Any]: ...
+
+    def get_text(self, response: Any) -> str: ...
+
+    def get_response_id(self, response: Any) -> Optional[str]: ...
+
+    def get_usage(self, response: Any) -> Optional[LLMUsage]: ...