Metadata-Version: 2.4
Name: agentic-sdk
Version: 0.0.1
Summary: Python bindings for the Agentic C++ SDK — orchestrate coding agents and LLMs with a unified session model, event stream, and tool system.
Project-URL: Homepage, https://github.com/BuildWithCollab/Agentic
Project-URL: Repository, https://github.com/BuildWithCollab/Agentic
Project-URL: Issues, https://github.com/BuildWithCollab/Agentic/issues
Author-email: Mrowr Purr <mrowr.purr@gmail.com>
License-Expression: 0BSD
License-File: LICENSE
Keywords: agent-orchestration,agentic,ai,claude-code,codex,coding-agent,gemini,llm,sdk,tools
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: C++
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# agentic-sdk

> ⚠️ **Pre-release placeholder.** This package reserves the name — the real thing is coming soon.

Python bindings for the [Agentic](https://github.com/BuildWithCollab/Agentic) C++ SDK — a unified library for orchestrating AI coding agents and direct LLM APIs.

## What it is

Agentic is a C++ SDK (with Python bindings via this package) that treats coding agents and LLM conversations as first-class **sessions** with a shared event model:

- **Unified session API** — the same `prompt` / event-stream interface whether you're talking to an LLM directly or driving a CLI coding agent like Claude Code, Gemini CLI, or Codex.
- **Structured event database** — every tool call, reasoning step, and response is captured in a queryable local database. Slice by session, tool, time, or full-text search.
- **Pythonic tool definitions** — define tools as decorated functions with Pydantic models. The LLM gets the schema, you get the type safety.
- **Async event streams** — subscribe to events as they happen, across sessions, across processes.
- **Forking** — branch a session at any point to explore alternate paths without losing the original context.
- **Extensible** — providers for new coding agents or LLMs load as dynamic libraries.

## Status

Not yet functional. The C++ SDK is under active development and the Python bindings will land shortly after it stabilizes.

If you're curious about the design, the full interface design document lives in the [main repo](https://github.com/BuildWithCollab/Agentic/blob/main/interface-designing.md).

## Coming soon

```python
import agentic
from agentic.tools import tool
from pydantic import BaseModel

class WeatherArgs(BaseModel):
    city: str

@tool(description="Get the weather for a city")
def weather(args: WeatherArgs) -> dict:
    return {"temp": 72, "conditions": "sunny"}

ctx = agentic.Context()

with ctx.llm_session(model="anthropic/claude-sonnet-4", tools=[weather]) as session:
    async for event in session.prompt("What's the weather in Portland?"):
        print(f"{event.event_type}: {event.content}")
```

## License

[0BSD](LICENSE) — BSD Zero Clause. Do whatever you want.
