Metadata-Version: 2.4
Name: oblivion-agent
Version: 2.10.0
Summary: OBLIVION - Terminal AI coding agent with voice, RAG, and multi-model support. Powered by Meera.
Project-URL: Homepage, https://github.com/rohit/oblivion-agent
Project-URL: Repository, https://github.com/rohit/oblivion-agent
Project-URL: Issues, https://github.com/rohit/oblivion-agent/issues
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: elevenlabs>=2.52.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>=1.0.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>=1.0.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

Terminal AI coding agent with voice, RAG, and multi-model support.
Powered by Meera.

## Install

    pip install oblivion-agent

With voice:

    pip install "oblivion-agent[voice]"

## First Run

    oblivion

A setup wizard will ask for your LLM provider (Gemini recommended, free).

## Features

- Voice in (Whisper) and out (Edge TTS / ElevenLabs)
- 9 LLM backends with auto-fallback (Gemini, Groq, Claude, GPT-4o, DeepSeek, Ollama, Cerebras)
- Hybrid code search: exact symbol + full-text + semantic embeddings
- 22 tools: filesystem, bash, symbol navigation, code verification, project memory
- Built-in knowledge packs (React, Django, FastAPI, Docker, security, more)
- Cyberpunk TUI with slash commands, file watcher, status bar
- Workspace memory persists across sessions (MEMORY.md per project)

## Slash Commands

- /help - all commands
- /model - switch LLM
- /voice - voice settings
- /meera on|off|test - toggle voice replies
- /index - reindex workspace
- /openproject <name> - switch project
- /newproject <name> - create project
- /memory - view workspace memory
- /stats - session info

## Config

Lives at ~/.oblivion/config.env


## Claude Desktop Integration (MCP)

Oblivion ships an MCP server. Claude Desktop can use Oblivions 10 read-only code tools directly.

### Setup

1. Install Oblivion:    pip install oblivion-agent

2. Find your Claude Desktop config file:
   macOS:   ~/Library/Application Support/Claude/claude_desktop_config.json
   Linux:   ~/.config/Claude/claude_desktop_config.json
   Windows: %APPDATA%/Claude/claude_desktop_config.json

3. Add this JSON to it:

    {
      "mcpServers": {
        "oblivion": {
          "command": "oblivion",
          "args": ["mcp"],
          "env": { "WORKSPACE_DIR": "/path/to/your/project" }
        }
      }
    }

4. Restart Claude Desktop. Done!

### Exposed tools (read-only)

read_file, list_dir, grep_files, file_exists, search_code,
find_symbol, list_symbols, find_callers, project_map, recall

Write tools are NOT exposed for safety. Use the Oblivion TUI for edits.

### Testing

    npx -y @modelcontextprotocol/inspector oblivion mcp


## License

MIT
