Metadata-Version: 2.4
Name: nexus-agentos
Version: 1.3.35
Summary: NexusAgent - Production-grade Agent Framework SDK
Author: Nexus Team
License: MIT
Keywords: agent,agent-framework,ai,llm,multi-agent
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
Requires-Python: >=3.10
Requires-Dist: httpx
Requires-Dist: pydantic>=2.0
Provides-Extra: aiohttp
Requires-Dist: aiohttp; extra == 'aiohttp'
Provides-Extra: all
Requires-Dist: aiohttp; extra == 'all'
Requires-Dist: openai; extra == 'all'
Requires-Dist: opentelemetry-exporter-otlp-proto-grpc>=1.20; extra == 'all'
Requires-Dist: opentelemetry-sdk>=1.20; extra == 'all'
Provides-Extra: dev
Requires-Dist: build>=1.0; extra == 'dev'
Requires-Dist: flake8>=6.0; extra == 'dev'
Requires-Dist: mypy>=1.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
Requires-Dist: pytest-cov>=4.0; extra == 'dev'
Requires-Dist: pytest-timeout>=2.0; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: ruff>=0.1; extra == 'dev'
Requires-Dist: twine>=4.0; extra == 'dev'
Provides-Extra: openai
Requires-Dist: openai; extra == 'openai'
Provides-Extra: telemetry
Requires-Dist: opentelemetry-exporter-otlp-proto-grpc>=1.20; extra == 'telemetry'
Requires-Dist: opentelemetry-sdk>=1.20; extra == 'telemetry'
Description-Content-Type: text/markdown

# Nexus AgentOS

High-performance multi-agent orchestration framework with resilience, observability, and swarm topology support.

```bash
pip install nexus-agentos
```

## Key Capabilities

| Module | Description |
|--------|-------------|
| `agentos.core` | Agent lifecycle (IDLE→THINKING→ACTING→OBSERVING), StreamEvent bus, tool dispatch |
| `agentos.memory` | L1 (short-term) / L2 (long-term) memory layers with semantic retrieval |
| `agentos.rag` | Text chunking, embedding pipeline, vector store backends |
| `agentos.swarm` | Swarm topologies (STAR/RING/MESH/TREE), pattern orchestration, A2A routing |
| `agentos.resilience` | Exponential backoff retry, circuit breaker, graceful degradation |
| `agentos.validation` | TypeGuard validators, object schemas, constraint enforcement |
| `agentos.telemetry` | OpenTelemetry bridge, structured logging, metrics registry |
| `agentos.errors` | AgentOSError root → TransientError/FatalError exception tree |
| `agentos.events` | EventBus with async pub/sub, snapshot/restore, delayed events |

## Quick Start

```python
from agentos.core import Agent, AgentState

agent = Agent(name="my_agent")
print(agent.state)  # AgentState.IDLE
```

## Test Suite

```bash
pytest agentos/tests/ -q  # 700+ tests, 0 failures
```

## License

MIT
