Metadata-Version: 2.4
Name: continuum-agent-sdk
Version: 1.0.0
Summary: Production-Grade Agent Framework with Crash Safety Guarantees
Project-URL: Homepage, https://github.com/continuum-ai/continuum
Project-URL: Documentation, https://continuum-agent-sdk.readthedocs.io
Project-URL: Repository, https://github.com/continuum-ai/continuum
Project-URL: Issues, https://github.com/continuum-ai/continuum/issues
Author: Continuum Team
License: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
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 :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: httpx>=0.25.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: toml>=0.10.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# Continuum Python SDK

A production-grade agent framework with crash safety guarantees.

## Quick Start (3 steps)

```python
from continuum import Agent

agent = Agent()  # Auto-loads config from environment
result = agent.run("your task")
```

## Installation

```bash
pip install continuum
```

## Configuration

### Environment Variables

Priority: `CONTINUUM_*` > `CONTINUUM_*` > `ANTHROPIC_*`

```bash
export CONTINUUM_API_KEY=your_api_key
export CONTINUUM_PROVIDER=anthropic  # or openai, google
export CONTINUUM_MODEL=claude-sonnet-4-6
```

### Config File

Create `~/.continuum/config.toml`:

```toml
[providers.anthropic]
api_key = "${ANTHROPIC_API_KEY}"
base_url = "https://api.anthropic.com/v1"
model = "claude-sonnet-4-6"

[providers.openai]
api_key = "${OPENAI_API_KEY}"
base_url = "https://api.openai.com/v1"
model = "gpt-4"

[settings]
session_auto_save = true
checkpoint_enabled = true
audit_enabled = true
```

## Features

- **Agent**: One-line agent creation with automatic configuration
- **Session**: Conversation history management with checkpoint support
- **Tools**: Built-in and custom tool registration
- **Memory**: Multi-layer memory system (episodic, semantic, procedural)
- **Config**: Multi-provider configuration with environment variable support

## API Reference

```python
from continuum import Agent, Session, Config

# Agent
agent = Agent(name="my-agent", model="claude-sonnet-4-6")
agent.run("task description")  # One-shot task execution
agent.chat("message")  # Interactive chat
agent.start()  # Start agent runtime

# Session
session = agent.create_session()
session.add_message("user", "Hello")
session.save()  # Persist to storage
session.load(session_id)  # Resume session

# Config
config = Config.from_env()  # Load from environment
config = Config.from_file("~/.continuum/config.toml")  # Load from file
config.use("openai")  # Switch provider
```

## License

MIT License
