Metadata-Version: 2.4
Name: agentforge-openai
Version: 0.2.4
Summary: OpenAI LLM + embeddings provider for AgentForge — gpt-4o / o-series + text-embedding-3-*
Project-URL: Homepage, https://github.com/Scaffoldic/agentforge-py
Project-URL: Repository, https://github.com/Scaffoldic/agentforge-py
Project-URL: Documentation, https://github.com/Scaffoldic/agentforge-py
Project-URL: Changelog, https://github.com/Scaffoldic/agentforge-py/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/Scaffoldic/agentforge-py/issues
Author: The AgentForge Authors
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: agent,ai,embeddings,gpt,llm,openai
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.13
Requires-Dist: agentforge-core~=0.2.4
Provides-Extra: openai
Requires-Dist: openai>=1.50; extra == 'openai'
Description-Content-Type: text/markdown

# agentforge-openai

OpenAI native LLM + embedding provider for
[AgentForge](https://github.com/Scaffoldic/agentforge-py).

Implements both `LLMClient` and `EmbeddingClient` against
OpenAI's `chat.completions.create()` (gpt-4o / o-series) and
`embeddings.create()` (text-embedding-3-small / -large).

## Install

```bash
pip install "agentforge-openai[openai]"
```

The bare `pip install agentforge-openai` install keeps the
package importable for tests; the production runner needs the
`openai` SDK, which the `[openai]` extra pulls in.

## Use

```python
from agentforge import Agent
from agentforge_openai import OpenAIClient, OpenAIEmbeddingClient

# Chat
agent = Agent(model="openai:gpt-4o-mini")

# Embeddings (direct construction)
emb = OpenAIEmbeddingClient.from_config(
    model="text-embedding-3-small",
    api_key="sk-...",
)
```

## Capabilities

`OpenAIClient.capabilities()` declares: `tools`, `json_mode`,
`streaming`, `vision` (for `gpt-4o*` variants). Caching and
extended thinking are not surfaced (OpenAI handles caching
transparently; o-series internal reasoning is not exposed as a
budget-able knob through the public API today).

## License

Apache-2.0. See [LICENSE](./LICENSE).
