Metadata-Version: 2.4
Name: septemberai
Version: 1.0.0
Summary: September platform SDK — the agentic engine and the citadel model gateway, one client.
Project-URL: Homepage, https://github.com/septemberai/september-sdk
Project-URL: Documentation, https://github.com/septemberai/september-sdk/tree/main/docs
Project-URL: Repository, https://github.com/septemberai/september-sdk
Project-URL: Changelog, https://github.com/septemberai/september-sdk/blob/main/contract/CHANGELOG.md
Project-URL: Issues, https://github.com/septemberai/september-sdk/issues
Author: September Platforms (P) LTD
License-Expression: MIT
License-File: LICENSE
Keywords: agentic,agents,ai,citadel,engine,llm,model-gateway,sdk,september,streaming
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: typing-extensions>=4.0
Provides-Extra: dev
Requires-Dist: mypy>=1.11; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: ruff>=0.6; extra == 'dev'
Description-Content-Type: text/markdown

# septemberai

The Python SDK for the September platform — the agentic **engine** and the **citadel** model gateway,
one client, sync and async.

```bash
# Python (3.10+)
pip install septemberai          # install name
# from september import September   # import name
```

```python
from september import September

sept = September(api_key=os.environ["SEPTEMBER_API_KEY"])

# agentic engine — stream typed blocks
for block in sept.engine.run("ship the build", craft=True):
    if block.type == "text":
        print(block.payload["text"], end="")

# citadel model gateway
reply = sept.citadel.messages.create(
    model="claude-opus-4-8",
    messages=[{"role": "user", "content": "hello"}],
    max_tokens=256,
)
```

The async client is `AsyncSeptember` with the identical surface (`async for`, `await`). The engine's
agentic surface (`run`/`Thread`/pause-resume) follows the Claude Agent SDK + Codex thread model; the
citadel + engine REST surface follows the Anthropic/OpenAI SDK conventions (resource methods,
streaming helpers, auto-pagination, typed errors).

See the [documentation](https://github.com/septemberai/september-sdk) for guides and the full
per-resource reference.
