Metadata-Version: 2.4
Name: nexus-ai-base
Version: 0.1.1
Summary: Core registry, configuration, and LLM abstractions for nexus-ai
License: MIT
Keywords: agents,ai,nexus,orchestration
Requires-Python: >=3.10
Requires-Dist: anyio>=4.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: opentelemetry-api>=1.27.0
Requires-Dist: opentelemetry-sdk>=1.27.0
Requires-Dist: pyyaml>=6.0
Provides-Extra: anthropic
Requires-Dist: anthropic>=0.36.0; extra == 'anthropic'
Requires-Dist: langchain-anthropic>=0.2.0; extra == 'anthropic'
Provides-Extra: google
Requires-Dist: google-generativeai>=0.8.0; extra == 'google'
Requires-Dist: langchain-google-genai>=2.0.0; extra == 'google'
Provides-Extra: local
Requires-Dist: langchain-ollama>=0.2.0; extra == 'local'
Provides-Extra: openai
Requires-Dist: langchain-openai>=0.2.0; extra == 'openai'
Requires-Dist: openai>=1.50.0; extra == 'openai'
Description-Content-Type: text/markdown

# nexus-ai-base

Core configuration, registry, security primitives, and LLM abstractions for the nexus-ai ecosystem.

This is the foundation package that all other nexus-ai packages build on. Install it directly only if you are building a custom integration — most users should install `nexus-ai-orchestrator` or `nexus-ai` instead.

## Install

```bash
pip install nexus-ai-base[anthropic]
pip install nexus-ai-base[openai]
pip install nexus-ai-base[google]
pip install nexus-ai-base[local]
```

## What's included

- `NexusConfig` / `LLMConfig` / `RouterConfig` — dataclass-based configuration with YAML and env-var loading
- `SecretRef` — wraps API keys so they never appear in logs or `repr()`
- `ToolRegistry` — central registry for all tools available to the agent
- `SecurityConfig` / `ContentPolicy` / `MCPSecurityPolicy` / `ThreadPolicy` — layered security primitives
- `TokenBudgetConfig` — token usage tracking and conversation compression

## License

MIT
