Metadata-Version: 2.4
Name: acr-runtime
Version: 0.1.0
Summary: ACR — Adaptive Cognitive Runtime: a local-first, model-independent AI orchestration and cognitive runtime.
Keywords: ai,agent,orchestration,llm,local-first,mcp,ollama
Author: hbkdad
License-Expression: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Dist: alembic>=1.18.5
Requires-Dist: fastapi>=0.140.13
Requires-Dist: httpx>=0.28.1
Requires-Dist: jinja2>=3.1.6
Requires-Dist: mcp>=1.0.0
Requires-Dist: playwright>=1.61.0
Requires-Dist: pydantic>=2.13.4
Requires-Dist: pydantic-settings>=2.14.2
Requires-Dist: pyyaml>=6.0.3
Requires-Dist: sqlalchemy[aiosqlite]>=2.0.51
Requires-Dist: structlog>=26.1.0
Requires-Dist: typer>=0.27.0
Requires-Dist: uvicorn>=0.38.0
Requires-Python: >=3.12
Project-URL: Homepage, https://github.com/hbkdad/arc
Project-URL: Repository, https://github.com/hbkdad/arc
Project-URL: Issues, https://github.com/hbkdad/arc/issues
Project-URL: Documentation, https://github.com/hbkdad/arc/blob/main/docs/ARCHITECTURE.md
Description-Content-Type: text/markdown

# ACR — Adaptive Cognitive Runtime

[![CI](https://github.com/hbkdad/arc/actions/workflows/ci.yml/badge.svg)](https://github.com/hbkdad/arc/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)

Local-first, model-independent AI orchestration and cognitive runtime.
Full specification: [`ACR_MASTER_SYSTEM_PROMPT.md`](ACR_MASTER_SYSTEM_PROMPT.md).
Current state and toolchain: [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md)
— that document is the single source of truth for exactly what phase this
repo is at; nothing here duplicates that status so it can't drift stale.

## What's here

A Python CLI (`acr`) built around a real task engine, a hybrid-retrieval
memory store, a skill registry with routing/validation/evolution, model
and tool routing with safe-mode-aware permission checks, an agent
planner/critic/topology system, an operational dashboard with a
real-telemetry visualization, and an MCP server exposing ACR's memory,
skill, web, and GitHub search tools to any MCP client. Runs entirely on
SQLite with a zero-config mock model provider by default — no cloud
account or API key required to try it. See
[`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) for the full breakdown of
what's implemented, how, and why.

## Quick start

```bash
uv sync                 # install deps + local package into .venv
cp .env.example .env    # local dev data dir (repo-local ./data, gitignored)
uv run alembic upgrade head
uv run acr doctor
```

```bash
uv run acr run "say hello"          # create + execute a task end to end
uv run acr dashboard serve          # operational dashboard: http://127.0.0.1:8765
uv run acr mcp serve                # MCP server (stdio by default)
```

### Using ACR from Claude Code

This repo ships a project-scoped [`.mcp.json`](.mcp.json), so opening it
in Claude Code offers ACR's memory/skill/web/GitHub search tools and task
execution as MCP tools directly — approve the prompt the first time it
asks, then they're available every session.

## Development

See [`CONTRIBUTING.md`](CONTRIBUTING.md) for the full workflow. Short version:

```bash
uv run pytest            # tests
uv run ruff check .      # lint
uv run ruff format .     # format
uv run pyright           # type check
```

## License, security, support

[MIT licensed](LICENSE). See [`SECURITY.md`](SECURITY.md) to report a
vulnerability privately. For bugs, questions, or feature requests, use
[GitHub Issues](https://github.com/hbkdad/arc/issues).
