Metadata-Version: 2.5
Name: oblivion-agent
Version: 3.2.0
Summary: OBLIVION - Terminal AI coding agent with voice, RAG, and multi-model support. Powered by Meera.
Project-URL: Homepage, https://github.com/Rohith-s-hub/Oblivion-agent
Project-URL: Repository, https://github.com/Rohith-s-hub/Oblivion-agent
Project-URL: Issues, https://github.com/Rohith-s-hub/Oblivion-agent/issues
Project-URL: Documentation, https://github.com/Rohith-s-hub/Oblivion-agent#readme
Project-URL: Changelog, https://github.com/Rohith-s-hub/Oblivion-agent/releases
Author: R. Rohit
License: MIT
License-File: LICENSE
Keywords: agent,ai,claude,coding,gemini,groq,llm,ollama,rag,tui,voice,whisper
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Code Generators
Requires-Python: >=3.11
Requires-Dist: aiosqlite>=0.20.0
Requires-Dist: chromadb>=1.5.0
Requires-Dist: edge-tts>=6.1.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: litellm>=1.40.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: pathspec>=0.12.1
Requires-Dist: pygments>=2.18.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: rich>=13.7.0
Requires-Dist: textual>=0.60.0
Requires-Dist: watchdog>=4.0.0
Provides-Extra: all
Requires-Dist: elevenlabs>=2.52.0; extra == 'all'
Requires-Dist: faster-whisper>=1.0.0; extra == 'all'
Requires-Dist: numpy>=2.0.0; extra == 'all'
Requires-Dist: scipy>=1.13.0; extra == 'all'
Requires-Dist: sounddevice>=0.4.0; extra == 'all'
Provides-Extra: premium-voice
Requires-Dist: elevenlabs>=2.52.0; extra == 'premium-voice'
Provides-Extra: voice
Requires-Dist: faster-whisper>=1.0.0; extra == 'voice'
Requires-Dist: numpy>=2.0.0; extra == 'voice'
Requires-Dist: scipy>=1.13.0; extra == 'voice'
Requires-Dist: sounddevice>=0.4.0; extra == 'voice'
Description-Content-Type: text/markdown

# OBLIVION AI 🔮
### Open-Source Terminal AI Coding Agent with Voice, 3-Layer RAG, and MCP Server

[![PyPI version](https://img.shields.io/pypi/v/oblivion-agent.svg?color=8b5cf6)](https://pypi.org/project/oblivion-agent/)
[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-22d3ee.svg)](https://www.python.org/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Downloads](https://img.shields.io/pypi/dm/oblivion-agent?color=67e8f9)](https://pypi.org/project/oblivion-agent/)

> *"Code is conversation. Make it natural."* — **M.E.E.R.A.**

Oblivion AI is a terminal-native, open-source AI coding agent built as a privacy-respecting, zero-cost alternative to proprietary tools like **Cursor, Copilot, and Claude Code**. It lives inside your terminal, understands your local codebase semantically, executes multi-file edits atomically, and responds via text or natural voice.

---



## 🔮 Oblivion AI Agent — The Best Open Source Terminal AI Agent

Oblivion AI is a terminal-native, open-source AI agent designed for developers who want a fast, privacy-first, and zero-cost alternative to proprietary coding tools. Functioning as a full **Oblivion Terminal Agent**, it lives inside your CLI, understands local codebases via 3-layer hybrid RAG, and executes multi-file code changes autonomously.


## 🌟 Key Highlights

* 🤖 **M.E.E.R.A. Core:** Powered by Multi-modal Engineering and Reasoning Assistant.
* ⚡ **Multi-Model Resilience:** Auto-fallback chain across **Ollama Cloud, Gemini 2.5, and Groq** with smart rate-limit cooldowns.
* 🎙️ **Voice I/O & Wake Word:** Background listening (`Hey Jarvis`), silence auto-stop (3s pause), and 8 neural voice personas via Edge-TTS / ElevenLabs.
* 🔍 **3-Layer Hybrid Search:** Instant exact symbol lookup (SQLite FTS5) + Full-text search + Vector semantic embeddings (ChromaDB).
* 🔌 **Built-in MCP Server:** Exposes 10 read-only code intelligence tools directly to **Claude Desktop, Cursor, and Zed**.
* 🛡️ **3-Tier Safety System:** Read, Mutate, and Destructive tiers with unified diff previews before execution.
* 🧰 **38 Agent Tools:** Full Git suite, test runners, multi-file atomic `batch_edit`, DuckDuckGo web search, PyPI/npm lookup, and background server management.
* 📟 **Intel 8085 CPU Emulator:** Built-in microprocessor simulator and assembler.

---

## 🎬 Live Demo

[![asciicast](https://asciinema.org/a/JWUP4sCednONtw0l.svg)](https://asciinema.org/a/JWUP4sCednONtw0l)

*Experience Oblivion AI in action: Multi-file generation, terminal UI, and real-time tool tracking.*

---

## ⚡ Quick Start

### Installation

```bash
# Basic text-only install
pip install oblivion-agent

# With local Voice STT + Neural TTS support (Recommended)
pip install "oblivion-agent[voice]"

# With premium ElevenLabs voice support
pip install "oblivion-agent[all]"
Run Oblivion AI
Bash

# Launch Terminal UI (TUI)
oblivion

# Launch MCP Server (for Claude Desktop / Cursor)
oblivion mcp

# Open MCP Inspector in Browser
oblivion inspect
🏗️ 3-Layer Hybrid Search Architecture
text

                    ┌─────────────────────────────────────────┐
                    │            USER QUERY                   │
                    │   "Where is parse_llm_output defined?"  │
                    └────────────────────┬────────────────────┘
                                         │
                   ┌─────────────────────┼─────────────────────┐
                   │                     │                     │
                   ▼                     ▼                     ▼
        ┌───────────────────┐ ┌────────────────────┐ ┌───────────────────┐
        │  LAYER 1: SYMBOL  │ │  LAYER 2: FTS5 TEXT│ │ LAYER 3: VECTOR   │
        │   SQLite Table    │ │   SQLite FTS5      │ │ ChromaDB + minilm │
        │  Exact Names Only │ │ Full-Text Match    │ │ Concept Matcher   │
        └─────────┬─────────┘ └─────────┬──────────┘ └─────────┬─────────┘
                  │                     │                      │
                  └─────────────────────┼──────────────────────┘
                                        │
                                        ▼
                   ┌─────────────────────────────────────────┐
                   │          MERGE & RANK ENGINE            │
                   │  1. Deduplicates exact line ranges      │
                   │  2. Symbol matches ALWAYS win rank #1    │
                   │  3. Merges vector context for fallback  │
                   └─────────────────────────────────────────┘
🔌 Claude Desktop MCP Integration
Connect Oblivion's code intelligence directly into Claude Desktop by adding this to your claude_desktop_config.json:

JSON

{
  "mcpServers": {
    "oblivion": {
      "command": "oblivion",
      "args": ["mcp"],
      "env": {
        "WORKSPACE_DIR": "/absolute/path/to/your/project"
      }
    }
  }
}
👨‍💻 Creator & Community
Oblivion AI was designed and built by Rohith R. (@Rohith-s-hub), a BSc Computer Science student from Tamil Nadu, India.

🌐 Website: oblivion.run.place
🐙 GitHub: @Rohith-s-hub
💼 LinkedIn: Rohith Rajkumar
📦 PyPI: oblivion-agent
📄 License
Distributed under the MIT License. Free for personal, academic, and commercial use.
