aria-x 1.2.0

ARIA — Autonomous Reasoning and Intelligent Agent. Your project-aware coding partner.

◉ ARIA

Autonomous Reasoning and Intelligent Agent

Your project-aware coding partner. Reason before action.

ARIA is an open-source CLI agent that works inside your project boundaries like a senior engineer — it plans before acting, validates its work, remembers context across sessions, and never silently modifies your system.

---

Install

pip install aria-x

aria --model nemotron-3-super:cloud

Requirements: Python 3.10+, Ollama

---

Demo

◉ aria(my-project) › Build a REST API with FastAPI and test it

─────────────────── Plan ───────────────────
  Goal: Build FastAPI REST API

  1. Scaffold project with venv + git
  2. Write endpoints
  3. Install dependencies in .venv
  4. Run server and test with curl

Proceed? (yes / no / modify): yes

  ◉ Scaffolding 'fastapi-api'...  step 1
  1. new_project  'fastapi-api'

  ◉ Writing main.py...  step 2
  2. write_file  'main.py'

  ◉ Installing fastapi uvicorn...  step 3
  3. run_command  '.venv/bin/pip install -r requirements.txt'
     │ Successfully installed fastapi uvicorn

  ◉ Running tests...  step 4
  4. run_command  'curl http://localhost:8000/health'
     │ {"status":"ok"}

─────────────────── Report ─────────────────
API built and tested. Run: uvicorn main:app --reload

---

What's New in v1.2.0

• Live Stream Bar — real-time status ticker during execution (◉ Writing auth.py... step 3)
• AST Validator — catches syntax and type errors before running code
• RAG + Web Search — searches real documentation when stuck on errors
• Loop Detection + Pivot — detects repeated failures, tries alternative approach
• Slash commands — /fix, /test, /explain, /commit, /review
• Git tools — commit, diff, branch from natural language
• Project memory — remembers context across sessions

---

Features

• Plan before action — shows what it will do, waits for your approval
• AST pre-validation — catches errors before running code (no hallucination at this layer)
• RAG with web search — searches real docs when stuck, not model memory
• Loop detection — detects repeated failures, pivots to alternative approach
• Project isolation — all packages go in .venv only, never touches system Python
• Project memory — remembers stack, decisions, and context across sessions
• Approval system — asks before dangerous operations
• Beautiful diffs — shows exactly what changed in every file
• Live status bar — always know what ARIA is doing

---

Slash Commands

Command	Description
/help	Show all commands
/fix	Fix bugs in current project
/test	Run tests, fix failures
/explain <file>	Explain code
/commit	Smart git commit
/review	Code review
/status	Session info
/model <name>	Switch model
/memory	Show project memory
/projects	List all ARIA projects
/exit	Exit

---

Models

aria --model nemotron-3-super:cloud   # Ollama cloud
aria --model devstral-2:123b          # Coding specialist
aria --model llama3.3                 # Local via Ollama
aria --model qwen2.5-coder:32b        # Local coding model

---

How it works

Clarify → Plan → Approve → Execute → Validate → Remember → Report

• AST Validator catches errors before execution
• RAG injects real documentation on errors
• Loop detector pivots approach after 3 repeated failures
• Memory persists decisions across sessions

---

Project Memory

~/.aria/
├── user_memory.json
└── projects/
    └── my-project/
        ├── meta.json      # Stack, status, path
        ├── memory.json    # Key decisions
        └── progress.md   # Milestone history

---

Built by

Sumit — independent developer
GitHub: Lonerider007
Email: [e-mail]

---

License

MIT