Metadata-Version: 2.4
Name: animus-core
Version: 2.3.0
Summary: An exocortex architecture for personal cognitive sovereignty
Author: AreteDriver
License: MIT
Project-URL: Homepage, https://github.com/AreteDriver/animus
Project-URL: Repository, https://github.com/AreteDriver/animus
Project-URL: Documentation, https://github.com/AreteDriver/animus#readme
Keywords: ai,personal-assistant,exocortex,llm
Classifier: Development Status :: 5 - Production/Stable
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
Description-Content-Type: text/markdown
Requires-Dist: ollama<1,>=0.1.0
Requires-Dist: chromadb>=0.4.22
Requires-Dist: pyyaml<7,>=6.0
Requires-Dist: pydantic<3,>=2.6.0
Requires-Dist: rich<15,>=13.7.0
Requires-Dist: prompt-toolkit<4,>=3.0.43
Provides-Extra: anthropic
Requires-Dist: anthropic>=0.18.0; extra == "anthropic"
Provides-Extra: openai
Requires-Dist: openai>=1.12.0; extra == "openai"
Provides-Extra: api
Requires-Dist: fastapi>=0.109.0; extra == "api"
Requires-Dist: uvicorn[standard]>=0.27.0; extra == "api"
Requires-Dist: python-multipart>=0.0.6; extra == "api"
Provides-Extra: voice
Requires-Dist: openai-whisper>=20231117; extra == "voice"
Requires-Dist: pyttsx3>=2.90; extra == "voice"
Requires-Dist: sounddevice>=0.4.6; extra == "voice"
Requires-Dist: soundfile>=0.12.1; extra == "voice"
Provides-Extra: integrations
Requires-Dist: google-api-python-client>=2.100.0; extra == "integrations"
Requires-Dist: google-auth>=2.20.0; extra == "integrations"
Requires-Dist: google-auth-oauthlib>=1.0.0; extra == "integrations"
Requires-Dist: todoist-api-python>=2.0.0; extra == "integrations"
Provides-Extra: gorgon
Requires-Dist: httpx>=0.26.0; extra == "gorgon"
Provides-Extra: sync
Requires-Dist: websockets>=12.0; extra == "sync"
Requires-Dist: zeroconf>=0.131.0; extra == "sync"
Provides-Extra: mcp
Requires-Dist: mcp>=1.0.0; extra == "mcp"
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-benchmark>=4.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
Requires-Dist: ruff>=0.2.0; extra == "dev"
Requires-Dist: mypy>=1.8.0; extra == "dev"
Requires-Dist: pre-commit>=3.6.0; extra == "dev"
Requires-Dist: httpx>=0.26.0; extra == "dev"
Provides-Extra: all
Requires-Dist: animus[anthropic,api,dev,gorgon,integrations,mcp,openai,sync,voice]; extra == "all"

# Animus Core

Personal AI exocortex with persistent memory, multi-model cognitive layer, and MCP server.

## Features

- **Persistent memory** — episodic, semantic, procedural (ChromaDB or SQLite)
- **Multi-model cognitive layer** — Ollama, Anthropic, OpenAI with streaming
- **Dual-model routing** — Claude brain + Ollama hands (auto-detected)
- **40+ CLI commands** — memory, tasks, entities, learning, integrations
- **MCP server** — 9 tools for Claude Code integration
- **Tool sandbox** — write_roots restriction, command sandboxing
- **Agent loop** — constrained tool use with approval callbacks

## Install

```bash
pip install animus-core
```

With optional providers:
```bash
pip install "animus[anthropic,openai,mcp,api]"
```

## Usage

```bash
# Interactive CLI
python -m animus

# MCP server for Claude Code
python -m animus.mcp_server
```

## Part of the Animus Monorepo

- [Animus Forge](https://github.com/AreteDriver/animus/tree/main/packages/forge) — multi-agent orchestration
- [Animus Quorum](https://pypi.org/project/convergentAI/) — coordination protocol
- [Animus Bootstrap](https://github.com/AreteDriver/animus/tree/main/packages/bootstrap) — system daemon

## License

MIT
