Metadata-Version: 2.4
Name: forge-aura
Version: 0.1.0
Summary: Aura — local-first, model-agnostic AI software development environment
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: fastapi==0.115.*
Requires-Dist: uvicorn[standard]==0.34.*
Requires-Dist: pydantic==2.12.*
Requires-Dist: python-dotenv==1.1.*
Requires-Dist: anthropic==0.52.*
Requires-Dist: openai==1.82.*
Requires-Dist: instructor==1.9.*
Requires-Dist: langgraph==0.4.*
Requires-Dist: tree-sitter==0.24.*
Requires-Dist: tree-sitter-typescript==0.23.*
Requires-Dist: tree-sitter-python==0.23.*
Requires-Dist: sentence-transformers==4.1.*
Requires-Dist: faiss-cpu==1.13.*
Requires-Dist: rank-bm25==0.2.*
Requires-Dist: aiosqlite==0.21.*
Requires-Dist: typer==0.15.*
Requires-Dist: rich==13.9.*
Requires-Dist: gitpython==3.1.*
Requires-Dist: watchfiles==1.1.*
Requires-Dist: websockets==14.2.*
Requires-Dist: sse-starlette==1.8.*
Requires-Dist: httpx==0.28.*
Requires-Dist: pyyaml==6.0.*
Provides-Extra: dev
Requires-Dist: pytest==8.3.*; extra == "dev"
Requires-Dist: pytest-asyncio==0.24.*; extra == "dev"
Requires-Dist: pytest-cov==6.0.*; extra == "dev"
Requires-Dist: ruff==0.8.*; extra == "dev"
Requires-Dist: mypy==1.13.*; extra == "dev"

# Aura

**Aura** is a local-first, model-agnostic AI software development environment. It runs as a daemon on your machine, indexes a project, and surfaces grounded answers and code changes through the **Aura VS Code extension** (and a secondary browser surface at `http://localhost:<port>/`).

This package (`forge-aura`) is the daemon and CLI. The user-facing local surface is the **Aura VS Code extension** (`aura.aura-vscode`), installed separately from the Visual Studio Code Marketplace.

## Status

Pre-1.0. The bridge-layer contract (the path from install to a real natural-language code change in VS Code) is the current bar; see the project's acceptance-gate spec for what's proven end-to-end. APIs, presets, and surfaces may change between minor versions.

## Install

```sh
pipx install forge-aura
```

Then install the **Aura** extension from the Visual Studio Code Marketplace, open a folder in VS Code, and let onboarding configure your provider keys and routing preset.

## Quick start

```sh
aura serve --daemon         # start the local daemon
aura status                 # show daemon + project state
aura stop                   # stop the daemon cleanly
```

In VS Code, open the Aura activity-bar view to reach the project picker; first-run takes you through onboarding (provider keys + routing preset) before any project is shown.

## Local-first by design

- API keys are stored in your user state directory (mode `0600`), never in YAML, never echoed back.
- No telemetry by default. No team server. No cloud Brain.
- Deleting your local state directory leaves your project a perfectly valid repo; Aura can re-bootstrap it from the open flow.

## Requires

- Python 3.11+ (3.12 recommended)
- A configured frontier-provider key for at least one of the supported routing presets (`balanced`, `dev_default`)

## License

See `LICENSE` in the source distribution.
