Metadata-Version: 2.4
Name: openyfai-aria
Version: 1.1.2
Summary: Local-first AI agent with memory, knowledge graph, tools, web dashboard, and Telegram (OpenYF AI).
Author: Youel
Maintainer: OpenYF AI
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/openyfai/aria
Project-URL: Repository, https://github.com/openyfai/aria
Project-URL: Issues, https://github.com/openyfai/aria/issues
Project-URL: Changelog, https://github.com/openyfai/aria/blob/main/CHANGELOG.md
Project-URL: Documentation, https://github.com/openyfai/aria#readme
Keywords: ai-agent,local-first,knowledge-graph,llm,autonomy,telegram,tools,memory
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: google-genai>=1.0.0
Requires-Dist: pydantic>=2.0
Requires-Dist: rich>=13.0
Requires-Dist: python-dotenv>=1.0
Requires-Dist: aiosqlite>=0.20.0
Requires-Dist: aiofiles>=24.0
Requires-Dist: networkx>=3.0
Requires-Dist: ddgs>=9.0.0
Requires-Dist: python-telegram-bot>=21.0
Requires-Dist: openai>=1.79.0
Requires-Dist: anthropic>=0.52.0
Requires-Dist: fastapi>=0.111
Requires-Dist: uvicorn>=0.30
Requires-Dist: playwright>=1.45
Requires-Dist: playwright-stealth>=1.0
Requires-Dist: html2text>=2024.2.26
Requires-Dist: chromadb>=0.5
Requires-Dist: docker>=7.0
Requires-Dist: httpx>=0.27
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.24; extra == "dev"
Requires-Dist: ruff>=0.5; extra == "dev"
Requires-Dist: mypy>=1.10; extra == "dev"
Provides-Extra: browser
Requires-Dist: playwright>=1.45; extra == "browser"
Requires-Dist: playwright-stealth>=1.0; extra == "browser"
Requires-Dist: html2text>=2024.2.26; extra == "browser"
Provides-Extra: vector
Requires-Dist: chromadb>=0.5; extra == "vector"
Provides-Extra: local
Requires-Dist: httpx>=0.27; extra == "local"
Dynamic: license-file

# ARIA by OpenYF AI

> Building intelligent systems. One phase at a time.

ARIA is an open source AI agent that lives on your machine, remembers everything you tell it, builds a knowledge graph of what it learns, improves itself over time, and works 24/7 — even while you sleep.

Not a chatbot. A cognitive agent with persistent memory, a world model, tool use, and a self-improvement loop. Built openly by [YF](https://github.com/openyfai) as the first step toward general intelligence.

[![PyPI](https://img.shields.io/pypi/v/openyfai-aria)](https://pypi.org/project/openyfai-aria/)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
[![Python](https://img.shields.io/badge/python-3.11+-green)](https://python.org)

---

## What makes ARIA different

Most AI tools forget you the moment the conversation ends. ARIA doesn't.

- **Persistent memory** — remembers everything across sessions, forever, stored locally on your machine
- **Knowledge graph** — builds a causal map of what it learns, not just a list of facts
- **Self-improvement loop** — critiques its own responses and retries when unsatisfied
- **Tool use** — web search, file access, code execution, browser
- **Multi-agent debate** — two instances argue opposing views to find truth
- **Telegram integration** — lives in your phone, works while your laptop is closed
- **Your data, your machine** — nothing leaves your device

---

## Install

```bash
pip install openyfai-aria
aria setup
```

Open **http://127.0.0.1:8000** and start talking.

> **Windows users:** If `aria` is not recognized after install, close and reopen your terminal. If blocked by Device Guard, run `python -m scripts.cli web` instead.

---

## The roadmap

ARIA is being built in 7 phases, in public, with full documentation of every decision.

| Phase | What it builds | Status |
|-------|---------------|--------|
| 01 | Cognitive core + persistent memory | ✅ Complete |
| 02 | World model — causal knowledge graph | ✅ Complete |
| 03 | Self-improvement loop | ✅ Complete |
| 04 | Multi-agent debate | ✅ Complete |
| 05 | Tool use + embodiment | ✅ Complete |
| 06 | Transfer + generalization | ✅ Complete |
| 07 | Recursive self-improvement | 🔄 In progress |

Full roadmap: [`docs/planning/ROADMAP.md`](docs/planning/ROADMAP.md)

---

## More ways to run

| Path | When to use |
|------|-------------|
| **Web UI** (`aria web`) | Default: finish setup in the browser. |
| **Terminal agent** (`aria` after setup) | Keyboard-first use. |
| **CLI setup only** (`aria setup`) | You prefer not to use the web wizard. |
| **Docker** | Deploy to a server or share on a LAN. See [`docs/quickstart.md`](docs/quickstart.md#deploy--server-docker). |

---

## Provider support

Gemini, OpenAI, Anthropic, OpenRouter, DeepSeek, Mistral, Groq, Ollama, and local OpenAI-compatible endpoints. Choose your provider during `aria setup` or change it anytime in settings.

---

## Skills

Add a Markdown file under `skills/`, restart ARIA, and the agent can use that workflow without touching Python. Start with [`skills/repo_researcher.md`](skills/repo_researcher.md) or [`skills/README.md`](skills/README.md).

---

## Safe defaults

ARIA ships locked down. Nothing runs without your approval.

- Tool approvals are **on**
- Terminal execution is **off**
- Direct code writes are **off**
- Background actions are **off**
- Remote web access requires `ARIA_WEB_API_KEY`
- Telegram is deny-by-default until paired from **Operator**

Read [`SECURITY.md`](SECURITY.md) before exposing ARIA beyond localhost.

---

## Requirements

- **Python** `>=3.11`
- **Node 20+** — only if you rebuild `aria-ui/` from source (not needed for `pip install`)
- **Docker** — optional

---

## Contributing

ARIA is built in public. Every decision is documented, every phase is open. Contributors welcome — see [`CONTRIBUTING.md`](CONTRIBUTING.md) and the seeded issues in [`docs/planning/launch-issue-backlog.md`](docs/planning/launch-issue-backlog.md) for good first tasks.

Follow the journey on X: [@openyfai](https://x.com/openyfai)

---

## Repository guide

| Path | What lives here |
|------|----------------|
| `aria/core/cognitive_loop.py` | Core cognitive pipeline |
| `aria/llm/` | LLM providers |
| `aria/memory/` | Memory store + retrieval |
| `aria/world/` | Knowledge graph + hypotheses |
| `scripts/web_server.py` | Web backend (FastAPI) |
| `scripts/cli.py` | CLI entrypoint |
| `scripts/telegram_bot.py` | Telegram integration |
| `aria-ui/src/` | Web UI (Next.js) |
| `skills/` | Markdown skill definitions |

---

## Development

```bash
git clone https://github.com/openyfai/aria.git && cd aria
pip install -e ".[dev]"
python -m pytest tests
ruff check .
```

To rebuild the web UI from source:

```bash
cd aria-ui && npm install && npm run build && cd ..
```

---

## Project docs

- [`docs/quickstart.md`](docs/quickstart.md) — install paths, Docker, troubleshooting
- [`CONTRIBUTING.md`](CONTRIBUTING.md)
- [`SECURITY.md`](SECURITY.md)
- [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md)
- [`docs/planning/ROADMAP.md`](docs/planning/ROADMAP.md)
- [`CHANGELOG.md`](CHANGELOG.md)

---

## License

Apache-2.0. See [`LICENSE`](LICENSE).

---

*OpenYF AI — building toward general intelligence, in public.*
