aria-x 1.0.1__tar.gz

aria_x-1.0.1/PKG-INFO

@@ -0,0 +1,174 @@
+Metadata-Version: 2.4
+Name: aria-x
+Version: 1.0.1
+Summary: ARIA — Autonomous Reasoning and Intelligent Agent. Your project-aware coding partner.
+Author-email: Sumit <samsungsumitv461@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/Lonerider007/aria-agent
+Keywords: ai,agent,cli,coding,llm,ollama
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: openai>=1.0.0
+Requires-Dist: rich>=13.0.0
+
+# ◉ 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, and remembers context across sessions.
+
+---
+
+## Demo
+
+```
+◉ aria(my-project) › Build a REST API with FastAPI and test it
+
+  ? What endpoints should the API have?
+  Answer: GET /health, POST /items, GET /items
+
+─────────────────── Plan ───────────────────
+  Goal: Build FastAPI REST API
+
+  1. Scaffold project with venv + git
+  2. Write main.py with endpoints
+  3. Install dependencies
+  4. Run server and test with curl
+  5. Update README
+
+Proceed? (yes / no / modify): yes
+
+  1. new_project  'fastapi-api'
+  2. write_file   'main.py'
+  3. run_command  '.venv/bin/pip install -r requirements.txt'
+     │ Successfully installed fastapi uvicorn
+  4. run_command  'curl http://localhost:8000/health'
+     │ {"status":"ok"}
+
+─────────────────── Report ─────────────────
+✅ API built and tested successfully.
+Files: main.py, requirements.txt, README.md
+Run: uvicorn main:app --reload
+```
+
+---
+
+## Features
+
+- **Plan before action** — shows you what it will do, waits for approval
+- **Validates everything** — runs code, reads output, fixes errors automatically
+- **Project memory** — remembers stack, decisions, and context across sessions
+- **Project isolation** — auto-creates git, venv, .env, .gitignore, README
+- **Approval system** — asks before dangerous operations
+- **Beautiful diffs** — shows exactly what changed in every file
+- **Git tools** — commit, diff, branch from natural language
+- **Streaming responses** — real-time output, not a black box
+
+---
+
+## Install
+
+```bash
+pip install aria-agent
+```
+
+Requirements: Python 3.10+, [Ollama](https://ollama.com) (for local/cloud models)
+
+---
+
+## Usage
+
+```bash
+# Run with default model
+aria
+
+# Run with specific model
+aria --model nemotron-3-super:cloud
+
+# Run with custom workspace
+aria --workspace ~/my-projects
+```
+
+---
+
+## Slash Commands
+
+| Command | Description |
+|---|---|
+| `/help` | Show all commands |
+| `/status` | Session info — model, workspace, turns |
+| `/clear` | Clear conversation history |
+| `/model <name>` | Switch model mid-session |
+| `/workspace <path>` | Change workspace |
+| `/apikey` | Update API key |
+| `/projects` | List all ARIA projects |
+| `/memory` | Show persistent memory |
+| `/tools` | List all agent tools |
+| `/exit` | Exit ARIA |
+
+---
+
+## Models
+
+ARIA works with any Ollama-compatible model:
+
+```bash
+aria --model nemotron-3-super:cloud   # Ollama cloud
+aria --model llama3.3                  # Local via Ollama
+aria --model qwen2.5-coder:32b         # Local coding model
+```
+
+---
+
+## How it works
+
+Every task follows this workflow:
+
+```
+Clarify → Plan → Approve → Execute → Validate → Remember → Report
+```
+
+ARIA never silently modifies your system. Every action is visible, every dangerous operation requires your approval.
+
+---
+
+## Project Memory
+
+ARIA stores project context in `~/.aria/`:
+
+```
+~/.aria/
+├── user_memory.json       # Your preferences
+└── projects/
+    └── my-project/
+        ├── meta.json      # Stack, status, path
+        ├── memory.json    # Key decisions
+        └── progress.md   # Milestone history
+```
+
+---
+
+## Built by
+
+**Sumit** — independent developer
+
+---
+
+## Contact
+
+For feedback, collaborations, or business inquiries:
+
+**Email:** samsungsumitv461@gmail.com  
+**GitHub:** [Lonerider007](https://github.com/Lonerider007)
+
+---
+
+## License
+
+MIT

aria_x-1.0.1/README.md

@@ -0,0 +1,156 @@
+# ◉ 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, and remembers context across sessions.
+
+---
+
+## Demo
+
+```
+◉ aria(my-project) › Build a REST API with FastAPI and test it
+
+  ? What endpoints should the API have?
+  Answer: GET /health, POST /items, GET /items
+
+─────────────────── Plan ───────────────────
+  Goal: Build FastAPI REST API
+
+  1. Scaffold project with venv + git
+  2. Write main.py with endpoints
+  3. Install dependencies
+  4. Run server and test with curl
+  5. Update README
+
+Proceed? (yes / no / modify): yes
+
+  1. new_project  'fastapi-api'
+  2. write_file   'main.py'
+  3. run_command  '.venv/bin/pip install -r requirements.txt'
+     │ Successfully installed fastapi uvicorn
+  4. run_command  'curl http://localhost:8000/health'
+     │ {"status":"ok"}
+
+─────────────────── Report ─────────────────
+✅ API built and tested successfully.
+Files: main.py, requirements.txt, README.md
+Run: uvicorn main:app --reload
+```
+
+---
+
+## Features
+
+- **Plan before action** — shows you what it will do, waits for approval
+- **Validates everything** — runs code, reads output, fixes errors automatically
+- **Project memory** — remembers stack, decisions, and context across sessions
+- **Project isolation** — auto-creates git, venv, .env, .gitignore, README
+- **Approval system** — asks before dangerous operations
+- **Beautiful diffs** — shows exactly what changed in every file
+- **Git tools** — commit, diff, branch from natural language
+- **Streaming responses** — real-time output, not a black box
+
+---
+
+## Install
+
+```bash
+pip install aria-agent
+```
+
+Requirements: Python 3.10+, [Ollama](https://ollama.com) (for local/cloud models)
+
+---
+
+## Usage
+
+```bash
+# Run with default model
+aria
+
+# Run with specific model
+aria --model nemotron-3-super:cloud
+
+# Run with custom workspace
+aria --workspace ~/my-projects
+```
+
+---
+
+## Slash Commands
+
+| Command | Description |
+|---|---|
+| `/help` | Show all commands |
+| `/status` | Session info — model, workspace, turns |
+| `/clear` | Clear conversation history |
+| `/model <name>` | Switch model mid-session |
+| `/workspace <path>` | Change workspace |
+| `/apikey` | Update API key |
+| `/projects` | List all ARIA projects |
+| `/memory` | Show persistent memory |
+| `/tools` | List all agent tools |
+| `/exit` | Exit ARIA |
+
+---
+
+## Models
+
+ARIA works with any Ollama-compatible model:
+
+```bash
+aria --model nemotron-3-super:cloud   # Ollama cloud
+aria --model llama3.3                  # Local via Ollama
+aria --model qwen2.5-coder:32b         # Local coding model
+```
+
+---
+
+## How it works
+
+Every task follows this workflow:
+
+```
+Clarify → Plan → Approve → Execute → Validate → Remember → Report
+```
+
+ARIA never silently modifies your system. Every action is visible, every dangerous operation requires your approval.
+
+---
+
+## Project Memory
+
+ARIA stores project context in `~/.aria/`:
+
+```
+~/.aria/
+├── user_memory.json       # Your preferences
+└── projects/
+    └── my-project/
+        ├── meta.json      # Stack, status, path
+        ├── memory.json    # Key decisions
+        └── progress.md   # Milestone history
+```
+
+---
+
+## Built by
+
+**Sumit** — independent developer
+
+---
+
+## Contact
+
+For feedback, collaborations, or business inquiries:
+
+**Email:** samsungsumitv461@gmail.com  
+**GitHub:** [Lonerider007](https://github.com/Lonerider007)
+
+---
+
+## License
+
+MIT

aria_x-1.0.1/aria/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.0.0"

aria_x-1.0.1/aria/agent.py

@@ -0,0 +1,154 @@
+import os
+import json
+from datetime import datetime
+
+from openai import OpenAI
+from aria.ui.console import console
+from aria.ui.streaming import stream_response, print_response
+from aria.memory.store import read_memory
+from aria.prompts import SYSTEM_PROMPT
+
+from aria.tools.files import (
+    read_file, write_file, edit_file,
+    delete_file, list_files, search_in_files
+)
+from aria.tools.shell import run_command, run_tests
+from aria.tools.git import git_status, git_diff, git_commit, git_create_branch, git_log
+from aria.tools.project import new_project, list_projects, mark_milestone
+from aria.tools.interaction import (
+    create_plan, ask_clarification,
+    request_approval, notify_user
+)
+from aria.memory.store import save_memory, read_memory
+from aria.memory.context import load_project_context
+
+TOOL_MAP = {
+    "read_file":           read_file,
+    "write_file":          write_file,
+    "edit_file":           edit_file,
+    "delete_file":         delete_file,
+    "list_files":          list_files,
+    "search_in_files":     search_in_files,
+    "run_command":         run_command,
+    "run_tests":           run_tests,
+    "git_status":          git_status,
+    "git_diff":            git_diff,
+    "git_commit":          git_commit,
+    "git_create_branch":   git_create_branch,
+    "git_log":             git_log,
+    "new_project":         new_project,
+    "list_projects":       list_projects,
+    "mark_milestone":      mark_milestone,
+    "create_plan":         create_plan,
+    "ask_clarification":   ask_clarification,
+    "request_approval":    request_approval,
+    "notify_user":         notify_user,
+    "save_memory":         save_memory,
+    "read_memory":         read_memory,
+    "load_project_context": load_project_context,
+}
+
+TOOLS = [
+    {"type":"function","function":{"name":"read_file","description":"Read file contents","parameters":{"type":"object","properties":{"path":{"type":"string"}},"required":["path"]}}},
+    {"type":"function","function":{"name":"write_file","description":"Create or overwrite a file","parameters":{"type":"object","properties":{"path":{"type":"string"},"content":{"type":"string"}},"required":["path","content"]}}},
+    {"type":"function","function":{"name":"edit_file","description":"Replace exact string in a file. Shows diff.","parameters":{"type":"object","properties":{"path":{"type":"string"},"old_str":{"type":"string"},"new_str":{"type":"string"}},"required":["path","old_str","new_str"]}}},
+    {"type":"function","function":{"name":"delete_file","description":"Delete a file","parameters":{"type":"object","properties":{"path":{"type":"string"}},"required":["path"]}}},
+    {"type":"function","function":{"name":"list_files","description":"List files in directory","parameters":{"type":"object","properties":{"path":{"type":"string"},"recursive":{"type":"boolean"}},"required":[]}}},
+    {"type":"function","function":{"name":"search_in_files","description":"Search pattern in files (grep)","parameters":{"type":"object","properties":{"pattern":{"type":"string"},"path":{"type":"string"},"file_pattern":{"type":"string"}},"required":["pattern"]}}},
+    {"type":"function","function":{"name":"run_command","description":"Run a shell command","parameters":{"type":"object","properties":{"command":{"type":"string"},"cwd":{"type":"string"}},"required":["command"]}}},
+    {"type":"function","function":{"name":"run_tests","description":"Run test suite","parameters":{"type":"object","properties":{"command":{"type":"string"},"cwd":{"type":"string"}},"required":[]}}},
+    {"type":"function","function":{"name":"git_status","description":"Git working tree status","parameters":{"type":"object","properties":{"cwd":{"type":"string"},"path":{"type":"string"}},"required":[]}}},
+    {"type":"function","function":{"name":"git_diff","description":"Show git diff","parameters":{"type":"object","properties":{"cwd":{"type":"string"},"path":{"type":"string"}},"required":[]}}},
+    {"type":"function","function":{"name":"git_commit","description":"Stage all and commit","parameters":{"type":"object","properties":{"message":{"type":"string"},"cwd":{"type":"string"},"path":{"type":"string"}},"required":["message"]}}},
+    {"type":"function","function":{"name":"git_create_branch","description":"Create and checkout a new branch","parameters":{"type":"object","properties":{"name":{"type":"string"},"cwd":{"type":"string"},"path":{"type":"string"}},"required":["name"]}}},
+    {"type":"function","function":{"name":"git_log","description":"Show recent git commits","parameters":{"type":"object","properties":{"n":{"type":"integer"},"cwd":{"type":"string"},"path":{"type":"string"}},"required":[]}}},
+    {"type":"function","function":{"name":"new_project","description":"Scaffold new project: folder, git, venv, .env, README. ALWAYS use for new projects.","parameters":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"stack":{"type":"string"},"path":{"type":"string"}},"required":["name","description","stack"]}}},
+    {"type":"function","function":{"name":"list_projects","description":"List all known ARIA projects","parameters":{"type":"object","properties":{},"required":[]}}},
+    {"type":"function","function":{"name":"mark_milestone","description":"Record project milestone with status","parameters":{"type":"object","properties":{"project":{"type":"string"},"milestone":{"type":"string"},"status":{"type":"string","enum":["done","in_progress","blocked"]},"notes":{"type":"string"}},"required":["project","milestone","status"]}}},
+    {"type":"function","function":{"name":"create_plan","description":"REQUIRED: Show plan to user and get approval before executing anything.","parameters":{"type":"object","properties":{"goal":{"type":"string"},"steps":{"type":"array","items":{"type":"string"}}},"required":["goal","steps"]}}},
+    {"type":"function","function":{"name":"ask_clarification","description":"Ask user a clarifying question when task is ambiguous.","parameters":{"type":"object","properties":{"question":{"type":"string"}},"required":["question"]}}},
+    {"type":"function","function":{"name":"request_approval","description":"Ask user approval before dangerous operations (delete, rm -rf, force push, etc).","parameters":{"type":"object","properties":{"action":{"type":"string"}},"required":["action"]}}},
+    {"type":"function","function":{"name":"notify_user","description":"Send status update to user during long tasks.","parameters":{"type":"object","properties":{"message":{"type":"string"},"level":{"type":"string","enum":["info","success","warning","error"]}},"required":["message"]}}},
+    {"type":"function","function":{"name":"save_memory","description":"Persist a key fact or decision for future sessions.","parameters":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"},"project":{"type":"string"}},"required":["key","value"]}}},
+    {"type":"function","function":{"name":"read_memory","description":"Load persisted memory from previous sessions.","parameters":{"type":"object","properties":{"project":{"type":"string"}},"required":[]}}},
+    {"type":"function","function":{"name":"load_project_context","description":"Load full project memory, history, and context. Call at start of any project task.","parameters":{"type":"object","properties":{"project":{"type":"string"}},"required":["project"]}}},
+]
+
+SILENT_TOOLS = {
+    "create_plan", "ask_clarification", "request_approval",
+    "notify_user", "mark_milestone"
+}
+
+
+class Agent:
+    def __init__(self, client: OpenAI, model: str):
+        self.client  = client
+        self.model   = model
+        self.turn    = 0
+        self.reset_messages()
+
+    def reset_messages(self):
+        user_mem = read_memory()
+        self.messages = [{
+            "role": "system",
+            "content": SYSTEM_PROMPT.format(
+                cwd=os.getcwd(),
+                time=datetime.now().strftime("%Y-%m-%d %H:%M"),
+                user_memory=user_mem
+            )
+        }]
+
+    def run(self, user_input: str):
+        self.turn += 1
+        self.messages.append({"role": "user", "content": user_input})
+        step_num = 0
+
+        while True:
+            msg_dict, tool_calls, text = stream_response(
+                self.client, self.model, self.messages, TOOLS
+            )
+            self.messages.append(msg_dict)
+
+            if not tool_calls:
+                print_response(text)
+                break
+
+            rejected = False
+            for tc in tool_calls:
+                name = tc["function"]["name"]
+                try:
+                    args = json.loads(tc["function"]["arguments"])
+                except json.JSONDecodeError:
+                    args = {}
+
+                if name not in SILENT_TOOLS:
+                    step_num += 1
+                    key_arg = next(iter(args.values()), "") if args else ""
+                    preview = repr(key_arg)[:70] if isinstance(key_arg, str) else ""
+                    console.print(
+                        f"  [aria.step]{step_num}.[/aria.step] "
+                        f"[aria.tool]{name}[/aria.tool]  "
+                        f"[aria.dim]{preview}[/aria.dim]"
+                    )
+
+                fn = TOOL_MAP.get(name)
+                result = fn(**args) if fn else f"ERROR: unknown tool '{name}'"
+
+                if name == "run_command" and result.strip():
+                    for line in result.strip().splitlines()[:10]:
+                        console.print(f"     [aria.dim]│ {line}[/aria.dim]")
+
+                self.messages.append({
+                    "role": "tool",
+                    "tool_call_id": tc["id"],
+                    "content": str(result)
+                })
+
+                # Hard stop if user rejected the plan
+                if str(result).startswith("USER_REJECTED"):
+                    console.print("\n  [aria.warning]◉[/aria.warning] [aria.dim]Task cancelled.[/aria.dim]")
+                    rejected = True
+                    break
+
+            if rejected:
+                break

aria_x-1.0.1/aria/config.py

@@ -0,0 +1,41 @@
+import json
+import os
+from pathlib import Path
+
+CONFIG_FILE = Path.home() / ".aria" / "config.json"
+
+DEFAULTS = {
+    "default_model": "llama3.3",
+    "base_url":      "http://localhost:11434/v1",
+    "api_key":       "",
+    "theme":         "purple",
+    "stream":        True,
+    "max_retries":   3,
+    "auto_approve":  False,
+}
+
+
+def load_config() -> dict:
+    if CONFIG_FILE.exists():
+        stored = json.loads(CONFIG_FILE.read_text())
+        return {**DEFAULTS, **stored}
+    return dict(DEFAULTS)
+
+
+def save_config(cfg: dict):
+    CONFIG_FILE.parent.mkdir(exist_ok=True)
+    CONFIG_FILE.write_text(json.dumps(cfg, indent=2))
+
+
+def get(key: str, fallback=None):
+    cfg = load_config()
+    env_map = {
+        "base_url":  "ARIA_BASE_URL",
+        "api_key":   "ARIA_API_KEY",
+        "default_model": "ARIA_MODEL",
+    }
+    if key in env_map:
+        env_val = os.getenv(env_map[key]) or os.getenv("OLLAMA_" + key.upper())
+        if env_val:
+            return env_val
+    return cfg.get(key, fallback)

aria_x-1.0.1/aria/main.py

@@ -0,0 +1,107 @@
+import os
+import sys
+import argparse
+from pathlib import Path
+
+from openai import OpenAI
+from rich.panel import Panel
+from rich.prompt import Prompt
+from prompt_toolkit import PromptSession
+from prompt_toolkit.history import InMemoryHistory
+from prompt_toolkit.styles import Style as PTStyle
+
+from aria.ui.console import console
+from aria.ui.banner import show_intro, show_tnc, show_banner, VERSION
+from aria.tools.interaction import masked_input
+from aria.config import get, load_config, save_config
+from aria.agent import Agent
+from aria.ui.commands import handle
+
+PT_STYLE = PTStyle.from_dict({
+    "prompt":      "#7C3AED bold",
+    "prompt.arg":  "#6B7280",
+})
+
+
+def onboarding(args) -> tuple:
+    show_intro()
+    console.print()
+    show_tnc()
+    console.print()
+
+    while True:
+        choice = Prompt.ask("[bold]agree / disagree[/bold]").strip().lower()
+        if choice == "agree":
+            console.print("[aria.success]✓[/aria.success] Accepted.\n")
+            break
+        elif choice == "disagree":
+            console.print("[aria.error]Exiting.[/aria.error]")
+            sys.exit(0)
+        else:
+            console.print("[aria.dim]Type 'agree' or 'disagree'.[/aria.dim]")
+
+    existing = args.api_key or get("api_key") or ""
+    hint = " (Enter to skip — not needed for local Ollama)" if not existing else " (Enter to use saved key)"
+    console.print(f"[aria.warning]API Key[/aria.warning][aria.dim]{hint}[/aria.dim]")
+    api_key = masked_input("Key: ").strip() or existing or "aria"
+
+    ws_input = Prompt.ask("[aria.warning]Workspace[/aria.warning]", default=os.getcwd()).strip()
+    workspace = str(Path(ws_input or os.getcwd()).expanduser().resolve())
+    if not Path(workspace).exists():
+        Path(workspace).mkdir(parents=True, exist_ok=True)
+        console.print(f"[aria.dim]Created:[/aria.dim] {workspace}")
+    os.chdir(workspace)
+    console.print(f"[aria.success]✓[/aria.success] Workspace: [aria.cyan]{workspace}[/aria.cyan]")
+
+    model_input = Prompt.ask("[aria.warning]Model[/aria.warning]", default=args.model).strip()
+    model = model_input or args.model
+    console.print(f"[aria.success]✓[/aria.success] Model:     [aria.cyan]{model}[/aria.cyan]\n")
+
+    return api_key, workspace, model
+
+
+def main():
+    parser = argparse.ArgumentParser(description="ARIA — Autonomous Reasoning and Intelligent Agent")
+    parser.add_argument("--model",    default=get("default_model", "llama3.3"))
+    parser.add_argument("--base-url", default=get("base_url", "http://localhost:11434/v1"))
+    parser.add_argument("--api-key",  default=get("api_key", ""))
+    args = parser.parse_args()
+
+    api_key, workspace, model = onboarding(args)
+
+    client = OpenAI(base_url=args.base_url, api_key=api_key)
+    agent  = Agent(client, model)
+    state  = {
+        "model":     model,
+        "workspace": workspace,
+        "api_key":   api_key,
+        "base_url":  args.base_url,
+    }
+
+    show_banner(model, workspace)
+
+    session = PromptSession(history=InMemoryHistory())
+
+    while True:
+        try:
+            cwd_short = Path(os.getcwd()).name
+            prompt_text = f"\n◉ aria({cwd_short}) › "
+            user_input = session.prompt(prompt_text, style=PT_STYLE).strip()
+        except (KeyboardInterrupt, EOFError):
+            console.print("\n[aria.dim]Session ended.[/aria.dim]")
+            break
+
+        if not user_input:
+            continue
+        if user_input.startswith("/"):
+            handle(user_input, agent, state)
+            continue
+        if user_input.lower() in ("exit", "quit", "q"):
+            console.print("[aria.dim]Session ended.[/aria.dim]")
+            break
+
+        agent.run(user_input)
+
+
+if __name__ == "__main__":
+    main()

aria_x-1.0.1/aria/memory/context.py

@@ -0,0 +1,29 @@
+import json
+from aria.memory.store import project_dir
+
+
+def load_project_context(project: str) -> str:
+    pd = project_dir(project)
+    parts = []
+
+    meta_f = pd / "meta.json"
+    if meta_f.exists():
+        meta = json.loads(meta_f.read_text())
+        parts.append(
+            f"Project: {meta.get('name')}  |  Stack: {meta.get('stack')}  "
+            f"|  Status: {meta.get('status')}  |  Path: {meta.get('path')}"
+        )
+
+    mem_f = pd / "memory.json"
+    if mem_f.exists():
+        data = json.loads(mem_f.read_text())
+        if data:
+            parts.append("Memory:\n" + "\n".join(f"  {k}: {v['value']}" for k, v in data.items()))
+
+    prog_f = pd / "progress.md"
+    if prog_f.exists():
+        content = prog_f.read_text().strip()
+        if content:
+            parts.append("Progress (recent):\n" + content[-600:])
+
+    return "\n\n".join(parts) if parts else "(no project context found)"