openyfai-aria 1.1.1

Local-first AI agent with memory, knowledge graph, tools, web dashboard, and Telegram (OpenYF AI).

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 as the first step toward general intelligence.

---

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

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

---

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.

---

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 or 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 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 and the seeded issues in docs/planning/launch-issue-backlog.md for good first tasks.

Follow the journey on X: @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

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:

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

---

Project docs

• docs/quickstart.md — install paths, Docker, troubleshooting
• CONTRIBUTING.md
• SECURITY.md
• CODE_OF_CONDUCT.md
• docs/planning/ROADMAP.md
• CHANGELOG.md

---

License

Apache-2.0. See LICENSE.

---

OpenYF AI — building toward general intelligence, in public.