elidia-agent-cli 0.4.2__tar.gz → 0.4.4__tar.gz

elidia_agent_cli-0.4.4/PKG-INFO

@@ -0,0 +1,365 @@
+Metadata-Version: 2.4
+Name: elidia-agent-cli
+Version: 0.4.4
+Summary: Elidia Agent CLI — Universal AI Agent for your terminal
+Author-email: Elidia Technology Pvt Ltd <support@aiutils.io>
+License-Expression: LicenseRef-Proprietary
+Project-URL: Homepage, https://elidia.dev
+Project-URL: Repository, https://github.com/Elidia-Technology/elidia-agent-cli
+Project-URL: Documentation, https://docs.elidia.dev
+Project-URL: Issues, https://github.com/Elidia-Technology/elidia-agent-cli/issues
+Project-URL: Changelog, https://github.com/Elidia-Technology/elidia-agent-cli/blob/main/CHANGELOG.md
+Keywords: ai,agent,cli,llm,mcp,coding-assistant,terminal
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1
+Requires-Dist: rich>=13.0
+Requires-Dist: prompt-toolkit>=3.0
+Requires-Dist: httpx[http2]>=0.27
+Requires-Dist: keyring>=25.0
+Requires-Dist: sqlite-vec>=0.1.9
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.24; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: aiosmtpd>=1.4; extra == "dev"
+Provides-Extra: local
+Requires-Dist: torch>=2.0; extra == "local"
+Requires-Dist: diffusers>=0.27; extra == "local"
+Requires-Dist: Pillow>=10.0; extra == "local"
+Provides-Extra: rag
+Requires-Dist: pymupdf>=1.24; extra == "rag"
+Requires-Dist: python-docx>=1.1; extra == "rag"
+Requires-Dist: openpyxl>=3.1; extra == "rag"
+Requires-Dist: python-pptx>=0.6; extra == "rag"
+Provides-Extra: pdf
+Requires-Dist: playwright>=1.45; extra == "pdf"
+Provides-Extra: database
+Requires-Dist: sqlalchemy>=2.0; extra == "database"
+Requires-Dist: sqlparse>=0.5; extra == "database"
+Provides-Extra: calendar
+Requires-Dist: icalendar>=5.0; extra == "calendar"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.6; extra == "docs"
+Requires-Dist: mkdocs-material>=9.5; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=0.25; extra == "docs"
+Dynamic: license-file
+
+<p align="center">
+  <h1 align="center">Elidia Agent CLI</h1>
+  <p align="center"><strong>Universal AI Agent for your terminal</strong></p>
+  <p align="center">
+    Code, research, create, orchestrate — with 50 LLMs, 36+ tools, and 5 execution modes.
+  </p>
+  <p align="center">
+    <a href="https://pypi.org/project/elidia-agent-cli/"><img src="https://img.shields.io/pypi/v/elidia-agent-cli?color=blue" alt="PyPI"></a>
+    <a href="https://pypi.org/project/elidia-agent-cli/"><img src="https://img.shields.io/pypi/pyversions/elidia-agent-cli" alt="Python"></a>
+    <a href="LICENSE"><img src="https://img.shields.io/badge/license-Proprietary-red" alt="License"></a>
+  </p>
+</p>
+
+---
+
+## What is Elidia Agent CLI?
+
+Elidia Agent CLI is a powerful terminal-based AI agent connecting you to **50 language models** through a single interface. It goes beyond chat — execute tools, run multi-model consensus, conduct deep research, generate images/video/audio, orchestrate complex workflows, and spawn parallel sub-agents (SWARM mode) — all from your terminal.
+
+Powered by the [AiUtils Developer API](https://developer.aiutils.io), Elidia Agent CLI gives you access to models from OpenAI, Anthropic, Google, DeepSeek, Meta, Alibaba, and more — with a single API key.
+
+## Key Features
+
+### 🎨 Hermes-Style Terminal UI *(v0.4.2)*
+- **ASCII art logo** — "ELIDIA AGENT" in ANSI Shadow at launch
+- **Styled prompt bar** — model, mode, context usage, timing, and cost before each input
+- **Rich welcome panel** — tools, MCP servers, execution modes, personas at a glance
+- **Theme support** — 6 built-in themes (default, dark, light, ocean, sunset, minimal)
+
+### 🤖 5 Execution Modes
+- **DIRECT** — fast single-model answers for simple questions
+- **CONSENSUS** — 2-3 models vote, synthesize the best response
+- **HARNESS** — multi-step agent loop with planning, tool use, self-correction
+- **DEEP** — extended reasoning with DeepEvaluator (8-dimension quality scoring)
+- **SWARM** — parallel sub-agents with full tool access for complex tasks
+
+### 🧠 Self-Learning System
+- **OutcomeTracker** — records every task execution (model, success/failure, tokens, cost)
+- **PatternLearner** — cross-session analysis for model optimization
+- **KnowledgeGraph** — LLM-powered entity + relation extraction from conversations
+- **Adaptive routing** — learned preferences influence model selection (30% weight)
+
+### 📋 Project Orchestrator
+- **SCRUM-style planning** — EPIC → Story → Ticket decomposition
+- **SprintExecutor** — multi-agent parallel execution with dependency ordering
+- **Iterative refinement** — 1-3 passes (small jobs) or 1-5 passes (large jobs)
+
+### 🔧 Built-in Tools (36+)
+- **File system** — read, write, search, manage files
+- **File upload** — PDF, DOC/DOCX, PPT/PPTX, CSV, TXT, XLS/XLSX, images, code (max 10 files, 50MB each)
+- **Git** — status, diff, log, commit
+- **Terminal** — shell commands with permission controls
+- **Web search** — multi-provider (Tavily, DuckDuckGo)
+- **Browser** — Playwright-based web automation
+- **Database** — read-only SQL with permission controls
+- **Email** — SMTP send + IMAP search/read
+- **Calendar** — local .ics read/write, conflict detection
+- **MCP support** — connect any MCP-compatible server
+
+### 🔬 Research Pipeline
+- **5-stage pipeline** — Decompose → Search → Analyze → Synthesize → Verify
+- **Cross-reference verification** — claims checked against search sources (not circular self-check)
+- **Export** — Markdown or HTML reports with citations
+
+### 🎨 Creative Generation
+- **Images** — FLUX, DALL-E, Stable Diffusion (500+ models)
+- **Video** — Kling, Minimax (500+ models)
+- **Speech** — ElevenLabs, OpenAI TTS (100+ models)
+- **Music** — Suno text-to-music
+
+### 🧩 Memory & RAG
+- **4-tier memory** — SYSTEM, USER, PROJECT, SESSION
+- **AutoMemory** — detects corrections, preferences, confirmations
+- **Vector search** — sqlite-vec with bge-m3 1024-dim embeddings
+- **Auto-compaction** — summarizes sessions into persistent memory
+- **Knowledge graph** — entities and relations extracted from conversations
+
+### 🔐 Security & Permissions
+- **4-tier system** — AUTO, SESSION, EVERY_TIME, NEVER
+- **Progressive trust** — auto-promotes trusted actions
+- **Audit logging** — every tool execution logged
+- **Keychain storage** — API keys via OS keychain, never plaintext
+
+---
+
+## Installation
+
+### From PyPI (recommended)
+
+```bash
+pip install elidia-agent-cli
+elidia auth login          # enter your AiUtils API key
+elidia ask "Hello!"        # send your first message
+```
+
+**If `elidia` command not found**, add pip's bin directory to PATH:
+
+```bash
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
+source ~/.zshrc
+```
+
+### Requirements
+
+- Python 3.11 or higher
+- An AiUtils Developer API key ([get one here](https://developer.aiutils.io))
+- macOS 12+, Ubuntu 22.04+, or Windows 10+
+
+---
+
+## Quick Start
+
+```bash
+# 1. Authenticate
+elidia auth login
+
+# 2. One-shot message
+elidia ask "Write a Python function to reverse a string"
+
+# 3. Interactive REPL (Hermes-style UI)
+elidia
+
+# 4. With file context
+elidia ask --file report.pdf "Summarize this document"
+
+# 5. With image analysis
+elidia ask --image photo.jpg "What's in this image?"
+
+# 6. Research mode
+elidia ask --mode research "Compare PostgreSQL vs MongoDB for time-series data"
+
+# 7. Specific model
+elidia ask --model claude-sonnet-4-6 "Review this code for bugs"
+```
+
+---
+
+## All Commands
+
+| Command | Description |
+|---|---|
+| `elidia` | Interactive REPL with Hermes-style UI and 29 slash commands |
+| `elidia ask <msg>` | One-shot message (supports `--model`, `--mode`, `--file`, `--image`) |
+| `elidia auth login/logout/status` | Manage API key |
+| `elidia auth email-login/email-logout/email-status` | Email credentials |
+| `elidia config show` | View configuration |
+| `elidia config set <section.field> <value>` | Persist preferences |
+| `elidia daemon start/stop/restart/status/init` | Background daemon |
+| `elidia mcp list/health` | MCP server management |
+| `elidia models` | List all 50 LLMs |
+| `elidia models --local` | List local Ollama models |
+| `elidia rag ingest/search/list/clear` | Local RAG document store |
+| `elidia session list/new/delete` | Session management |
+| `elidia version` | Show version |
+| `elidia workflow run <file>` | Execute YAML workflow |
+
+---
+
+## REPL Commands (29 total)
+
+| Command | Description |
+|---|---|
+| `/model [name]` | Switch model or show current |
+| `/mode [mode]` | Switch mode (chat/code/research/think/create) |
+| `/think [level]` | Set thinking depth (minimal/low/medium/high/max) |
+| `/persona [slug]` | Switch domain persona (developer, doctor, lawyer, etc.) |
+| `/research <query>` | 5-stage deep research pipeline |
+| `/create image\|video\|speech\|music <prompt>` | AI media generation |
+| `/workflow <file.yaml>` | Execute YAML workflow |
+| `/tools [category]` | List available tools grouped by category |
+| `/mcp [disconnect]` | MCP server status |
+| `/image <path> [message]` | Attach image for vision analysis |
+| `/rag ingest\|search\|list\|clear` | Manage RAG document store |
+| `/memory search\|save\|forget\|list` | Persistent memory management |
+| `/history [query]` | Search chat history |
+| `/sessions` | List sessions |
+| `/outcomes [best\|failures]` | Model performance rankings, failure patterns |
+| `/analyze` | Full learning report (trends, preferences, routing hints) |
+| `/knowledge [query]` | Search knowledge graph for entities and relations |
+| `/balance` | Check DT balance |
+| `/cost` | Session cost breakdown |
+| `/budget` | Budget governor status |
+| `/daemon status\|start\|stop` | Background daemon control |
+| `/theme [name]` | Switch UI theme (default/dark/light/ocean/sunset/minimal) |
+| `/cache [on\|off\|clear]` | Response cache control |
+| `/pager [on\|off]` | Auto-pager for long responses |
+| `/new` | Start new session (compacts current) |
+| `/clear` | Clear conversation |
+| `/rules` | Show project rules (.elidia/rules.md) |
+| `/trust` | Show trust engine promotions |
+| `/help [command]` | Show help |
+
+---
+
+## Available Models
+
+### Language Models (LLMs) — 50 total
+Claude (Opus, Sonnet, Haiku), GPT (4o, 4.5, 5.5, o3, o4-mini), Gemini (2.5 Pro/Flash), DeepSeek (V4, Reasoner), Llama (4 Scout/Maverick, 3.3 70B), Qwen (3, 2.5 72B), Mistral (Large, Codestral), and more across 6 vendors (OpenAI, Anthropic, DeepSeek, PIAPI/Elidia-1, Local/Ollama, Aiutils).
+
+### Creative Models — available through `/create` and chat
+| Category | Count | Examples |
+|---|---|---|
+| Image Generation | 500+ | FLUX, SDXL, DALL-E, Midjourney |
+| Video Generation | 500+ | Runway, Pika, Kling, Sora |
+| Audio/Music | 100+ | ElevenLabs, MusicGen, Whisper |
+| 3D Generation | 50+ | TripoSR, Zero123++, Stable3D |
+
+### Local Models — `elidia models --local`
+Ollama models running on your machine. Zero API cost, works offline.
+```bash
+ollama pull llama3.2:3b
+elidia models --local
+```
+
+---
+
+## Configuration
+
+`~/.elidia/config.toml`:
+
+```toml
+[api]
+base_url = "https://developer.aiutils.io/v1"
+timeout_seconds = 120
+
+[models]
+default = "claude-sonnet-4-6"
+code = "claude-sonnet-4-6"
+reasoning = "deepseek-reasoner"
+creative = "auto"
+
+[permissions]
+default_level = "session"
+
+[budget]
+session_limit_dt = 50000.0
+
+[theme]
+name = "default"
+```
+
+---
+
+## MCP Integration
+
+Connect any MCP-compatible server:
+
+```json
+// ~/.elidia/mcp.json
+{
+  "mcpServers": {
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": { "GITHUB_TOKEN": "ghp_..." }
+    },
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
+    }
+  }
+}
+```
+
+---
+
+## Workflow Example
+
+```yaml
+# research.yaml
+name: competitor-analysis
+steps:
+  - name: research
+    type: llm
+    prompt: "List top 5 AI coding assistants with key features"
+    output: findings
+
+  - name: analyze
+    type: llm
+    prompt: "Create a comparison table:\n{{findings}}"
+    output: analysis
+
+  - name: save
+    type: shell
+    command: "echo '{{analysis}}' > competitor-report.md"
+```
+
+```bash
+elidia workflow run research.yaml
+```
+
+---
+
+## Support
+
+- **PyPI:** [pypi.org/project/elidia-agent-cli](https://pypi.org/project/elidia-agent-cli/)
+- **GitHub:** [github.com/Elidia-Technology/elidia-agent-cli](https://github.com/Elidia-Technology/elidia-agent-cli)
+- **Email:** support@aiutils.io
+
+---
+
+## License
+
+Proprietary software. Copyright 2026 Elidia Technology Pvt Ltd. All Rights Reserved.
+See [LICENSE](LICENSE) for full terms.

elidia_agent_cli-0.4.4/README.md

@@ -0,0 +1,305 @@
+<p align="center">
+  <h1 align="center">Elidia Agent CLI</h1>
+  <p align="center"><strong>Universal AI Agent for your terminal</strong></p>
+  <p align="center">
+    Code, research, create, orchestrate — with 50 LLMs, 36+ tools, and 5 execution modes.
+  </p>
+  <p align="center">
+    <a href="https://pypi.org/project/elidia-agent-cli/"><img src="https://img.shields.io/pypi/v/elidia-agent-cli?color=blue" alt="PyPI"></a>
+    <a href="https://pypi.org/project/elidia-agent-cli/"><img src="https://img.shields.io/pypi/pyversions/elidia-agent-cli" alt="Python"></a>
+    <a href="LICENSE"><img src="https://img.shields.io/badge/license-Proprietary-red" alt="License"></a>
+  </p>
+</p>
+
+---
+
+## What is Elidia Agent CLI?
+
+Elidia Agent CLI is a powerful terminal-based AI agent connecting you to **50 language models** through a single interface. It goes beyond chat — execute tools, run multi-model consensus, conduct deep research, generate images/video/audio, orchestrate complex workflows, and spawn parallel sub-agents (SWARM mode) — all from your terminal.
+
+Powered by the [AiUtils Developer API](https://developer.aiutils.io), Elidia Agent CLI gives you access to models from OpenAI, Anthropic, Google, DeepSeek, Meta, Alibaba, and more — with a single API key.
+
+## Key Features
+
+### 🎨 Hermes-Style Terminal UI *(v0.4.2)*
+- **ASCII art logo** — "ELIDIA AGENT" in ANSI Shadow at launch
+- **Styled prompt bar** — model, mode, context usage, timing, and cost before each input
+- **Rich welcome panel** — tools, MCP servers, execution modes, personas at a glance
+- **Theme support** — 6 built-in themes (default, dark, light, ocean, sunset, minimal)
+
+### 🤖 5 Execution Modes
+- **DIRECT** — fast single-model answers for simple questions
+- **CONSENSUS** — 2-3 models vote, synthesize the best response
+- **HARNESS** — multi-step agent loop with planning, tool use, self-correction
+- **DEEP** — extended reasoning with DeepEvaluator (8-dimension quality scoring)
+- **SWARM** — parallel sub-agents with full tool access for complex tasks
+
+### 🧠 Self-Learning System
+- **OutcomeTracker** — records every task execution (model, success/failure, tokens, cost)
+- **PatternLearner** — cross-session analysis for model optimization
+- **KnowledgeGraph** — LLM-powered entity + relation extraction from conversations
+- **Adaptive routing** — learned preferences influence model selection (30% weight)
+
+### 📋 Project Orchestrator
+- **SCRUM-style planning** — EPIC → Story → Ticket decomposition
+- **SprintExecutor** — multi-agent parallel execution with dependency ordering
+- **Iterative refinement** — 1-3 passes (small jobs) or 1-5 passes (large jobs)
+
+### 🔧 Built-in Tools (36+)
+- **File system** — read, write, search, manage files
+- **File upload** — PDF, DOC/DOCX, PPT/PPTX, CSV, TXT, XLS/XLSX, images, code (max 10 files, 50MB each)
+- **Git** — status, diff, log, commit
+- **Terminal** — shell commands with permission controls
+- **Web search** — multi-provider (Tavily, DuckDuckGo)
+- **Browser** — Playwright-based web automation
+- **Database** — read-only SQL with permission controls
+- **Email** — SMTP send + IMAP search/read
+- **Calendar** — local .ics read/write, conflict detection
+- **MCP support** — connect any MCP-compatible server
+
+### 🔬 Research Pipeline
+- **5-stage pipeline** — Decompose → Search → Analyze → Synthesize → Verify
+- **Cross-reference verification** — claims checked against search sources (not circular self-check)
+- **Export** — Markdown or HTML reports with citations
+
+### 🎨 Creative Generation
+- **Images** — FLUX, DALL-E, Stable Diffusion (500+ models)
+- **Video** — Kling, Minimax (500+ models)
+- **Speech** — ElevenLabs, OpenAI TTS (100+ models)
+- **Music** — Suno text-to-music
+
+### 🧩 Memory & RAG
+- **4-tier memory** — SYSTEM, USER, PROJECT, SESSION
+- **AutoMemory** — detects corrections, preferences, confirmations
+- **Vector search** — sqlite-vec with bge-m3 1024-dim embeddings
+- **Auto-compaction** — summarizes sessions into persistent memory
+- **Knowledge graph** — entities and relations extracted from conversations
+
+### 🔐 Security & Permissions
+- **4-tier system** — AUTO, SESSION, EVERY_TIME, NEVER
+- **Progressive trust** — auto-promotes trusted actions
+- **Audit logging** — every tool execution logged
+- **Keychain storage** — API keys via OS keychain, never plaintext
+
+---
+
+## Installation
+
+### From PyPI (recommended)
+
+```bash
+pip install elidia-agent-cli
+elidia auth login          # enter your AiUtils API key
+elidia ask "Hello!"        # send your first message
+```
+
+**If `elidia` command not found**, add pip's bin directory to PATH:
+
+```bash
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
+source ~/.zshrc
+```
+
+### Requirements
+
+- Python 3.11 or higher
+- An AiUtils Developer API key ([get one here](https://developer.aiutils.io))
+- macOS 12+, Ubuntu 22.04+, or Windows 10+
+
+---
+
+## Quick Start
+
+```bash
+# 1. Authenticate
+elidia auth login
+
+# 2. One-shot message
+elidia ask "Write a Python function to reverse a string"
+
+# 3. Interactive REPL (Hermes-style UI)
+elidia
+
+# 4. With file context
+elidia ask --file report.pdf "Summarize this document"
+
+# 5. With image analysis
+elidia ask --image photo.jpg "What's in this image?"
+
+# 6. Research mode
+elidia ask --mode research "Compare PostgreSQL vs MongoDB for time-series data"
+
+# 7. Specific model
+elidia ask --model claude-sonnet-4-6 "Review this code for bugs"
+```
+
+---
+
+## All Commands
+
+| Command | Description |
+|---|---|
+| `elidia` | Interactive REPL with Hermes-style UI and 29 slash commands |
+| `elidia ask <msg>` | One-shot message (supports `--model`, `--mode`, `--file`, `--image`) |
+| `elidia auth login/logout/status` | Manage API key |
+| `elidia auth email-login/email-logout/email-status` | Email credentials |
+| `elidia config show` | View configuration |
+| `elidia config set <section.field> <value>` | Persist preferences |
+| `elidia daemon start/stop/restart/status/init` | Background daemon |
+| `elidia mcp list/health` | MCP server management |
+| `elidia models` | List all 50 LLMs |
+| `elidia models --local` | List local Ollama models |
+| `elidia rag ingest/search/list/clear` | Local RAG document store |
+| `elidia session list/new/delete` | Session management |
+| `elidia version` | Show version |
+| `elidia workflow run <file>` | Execute YAML workflow |
+
+---
+
+## REPL Commands (29 total)
+
+| Command | Description |
+|---|---|
+| `/model [name]` | Switch model or show current |
+| `/mode [mode]` | Switch mode (chat/code/research/think/create) |
+| `/think [level]` | Set thinking depth (minimal/low/medium/high/max) |
+| `/persona [slug]` | Switch domain persona (developer, doctor, lawyer, etc.) |
+| `/research <query>` | 5-stage deep research pipeline |
+| `/create image\|video\|speech\|music <prompt>` | AI media generation |
+| `/workflow <file.yaml>` | Execute YAML workflow |
+| `/tools [category]` | List available tools grouped by category |
+| `/mcp [disconnect]` | MCP server status |
+| `/image <path> [message]` | Attach image for vision analysis |
+| `/rag ingest\|search\|list\|clear` | Manage RAG document store |
+| `/memory search\|save\|forget\|list` | Persistent memory management |
+| `/history [query]` | Search chat history |
+| `/sessions` | List sessions |
+| `/outcomes [best\|failures]` | Model performance rankings, failure patterns |
+| `/analyze` | Full learning report (trends, preferences, routing hints) |
+| `/knowledge [query]` | Search knowledge graph for entities and relations |
+| `/balance` | Check DT balance |
+| `/cost` | Session cost breakdown |
+| `/budget` | Budget governor status |
+| `/daemon status\|start\|stop` | Background daemon control |
+| `/theme [name]` | Switch UI theme (default/dark/light/ocean/sunset/minimal) |
+| `/cache [on\|off\|clear]` | Response cache control |
+| `/pager [on\|off]` | Auto-pager for long responses |
+| `/new` | Start new session (compacts current) |
+| `/clear` | Clear conversation |
+| `/rules` | Show project rules (.elidia/rules.md) |
+| `/trust` | Show trust engine promotions |
+| `/help [command]` | Show help |
+
+---
+
+## Available Models
+
+### Language Models (LLMs) — 50 total
+Claude (Opus, Sonnet, Haiku), GPT (4o, 4.5, 5.5, o3, o4-mini), Gemini (2.5 Pro/Flash), DeepSeek (V4, Reasoner), Llama (4 Scout/Maverick, 3.3 70B), Qwen (3, 2.5 72B), Mistral (Large, Codestral), and more across 6 vendors (OpenAI, Anthropic, DeepSeek, PIAPI/Elidia-1, Local/Ollama, Aiutils).
+
+### Creative Models — available through `/create` and chat
+| Category | Count | Examples |
+|---|---|---|
+| Image Generation | 500+ | FLUX, SDXL, DALL-E, Midjourney |
+| Video Generation | 500+ | Runway, Pika, Kling, Sora |
+| Audio/Music | 100+ | ElevenLabs, MusicGen, Whisper |
+| 3D Generation | 50+ | TripoSR, Zero123++, Stable3D |
+
+### Local Models — `elidia models --local`
+Ollama models running on your machine. Zero API cost, works offline.
+```bash
+ollama pull llama3.2:3b
+elidia models --local
+```
+
+---
+
+## Configuration
+
+`~/.elidia/config.toml`:
+
+```toml
+[api]
+base_url = "https://developer.aiutils.io/v1"
+timeout_seconds = 120
+
+[models]
+default = "claude-sonnet-4-6"
+code = "claude-sonnet-4-6"
+reasoning = "deepseek-reasoner"
+creative = "auto"
+
+[permissions]
+default_level = "session"
+
+[budget]
+session_limit_dt = 50000.0
+
+[theme]
+name = "default"
+```
+
+---
+
+## MCP Integration
+
+Connect any MCP-compatible server:
+
+```json
+// ~/.elidia/mcp.json
+{
+  "mcpServers": {
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": { "GITHUB_TOKEN": "ghp_..." }
+    },
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
+    }
+  }
+}
+```
+
+---
+
+## Workflow Example
+
+```yaml
+# research.yaml
+name: competitor-analysis
+steps:
+  - name: research
+    type: llm
+    prompt: "List top 5 AI coding assistants with key features"
+    output: findings
+
+  - name: analyze
+    type: llm
+    prompt: "Create a comparison table:\n{{findings}}"
+    output: analysis
+
+  - name: save
+    type: shell
+    command: "echo '{{analysis}}' > competitor-report.md"
+```
+
+```bash
+elidia workflow run research.yaml
+```
+
+---
+
+## Support
+
+- **PyPI:** [pypi.org/project/elidia-agent-cli](https://pypi.org/project/elidia-agent-cli/)
+- **GitHub:** [github.com/Elidia-Technology/elidia-agent-cli](https://github.com/Elidia-Technology/elidia-agent-cli)
+- **Email:** support@aiutils.io
+
+---
+
+## License
+
+Proprietary software. Copyright 2026 Elidia Technology Pvt Ltd. All Rights Reserved.
+See [LICENSE](LICENSE) for full terms.