Metadata-Version: 2.4
Name: andromity
Version: 0.2.7
Summary: AI coding agent with a beautiful terminal UI. Works with Claude, Gemini, GPT, Ollama and more.
Author-email: Agentic Market <hello@agenticmarket.dev>
License: MIT
Project-URL: Homepage, https://agenticmarket.dev
Project-URL: Repository, https://github.com/agenticmarket/andromity
Project-URL: Bug Tracker, https://github.com/agenticmarket/andromity/issues
Keywords: ai,coding-agent,tui,terminal,llm,claude,gemini,mcp,cli
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
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 :: Software Development
Classifier: Topic :: Terminals
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: textual<9.0,>=8.2.8
Requires-Dist: pillow>=10.0
Requires-Dist: litellm<2.0,>=1.50
Requires-Dist: tomli>=2.0; python_version < "3.12"
Requires-Dist: tomli-w>=1.0
Requires-Dist: gitpython>=3.1
Requires-Dist: rich>=13.0
Requires-Dist: click>=8.0
Requires-Dist: mcp<2.0,>=1.0.0
Requires-Dist: httpx>=0.28.0
Requires-Dist: httpx-sse>=0.4.0
Requires-Dist: watchdog>=3.0
Requires-Dist: markdownify>=0.14.0
Requires-Dist: ddgs>=1.0.0
Requires-Dist: textual-plotext>=0.2.1
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
Dynamic: license-file

<div align="center">
  <img src="andromity.png" alt="Andromity" width="70" height="70" />

  # Andromity — AI Coding Agent for VS Code & Terminal

  **Trust-governed, BYOK, autonomous coding agent with subagents, live plans, native diffs & one-click rollback.**

  [![VS Code Marketplace](https://img.shields.io/badge/VS_Marketplace-v0.2.6-blueviolet?logo=visualstudiocode)](https://marketplace.visualstudio.com/items?itemName=agenticmarket.andromity-agent)
  [![PyPI](https://img.shields.io/pypi/v/andromity)](https://pypi.org/project/andromity/)
  ![Python](https://img.shields.io/badge/python-3.11+-blue)
  [![Tests](https://github.com/agenticmarket/andromity/actions/workflows/tests.yml/badge.svg)](https://github.com/agenticmarket/andromity/actions/workflows/tests.yml)
  [![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)

  English | [简体中文](README.zh-CN.md) | [Русский](README.ru.md) | [Português (Brasil)](README.pt-BR.md) | [日本語](README.ja.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [हिन्दी](README.hi.md)

</div>

<div align="center">
  <img src="vscode-extension/walkthroughs/assets/partner.webp" alt="Andromity AI Coding Partner in VS Code" width="100%" />
</div>

---

**Andromity** is a private, BYOK (Bring Your Own Key) autonomous AI coding agent. Use it inside VS Code with the extension, or run it as a standalone terminal workspace. It plans complex tasks, manages parallel subagents, shows live step-by-step blueprints, lets you review diffs before applying, and gives you instant one-click rollback.

Connect your preferred AI model (**Claude 3.7 Sonnet, GPT-4o, Gemini 2.5 Pro, DeepSeek R1 & V3, Groq, OpenRouter**) or run **100% locally and free with Ollama**.

---

## ⚡ Get Started

### Option A: VS Code Extension (Recommended)

Install directly from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=agenticmarket.andromity-agent):

```bash
code --install-extension agenticmarket.andromity-agent
```

### Option B: Terminal CLI

```bash
# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/agenticmarket/andromity/main/install.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/agenticmarket/andromity/main/install.ps1 | iex

# Or with pipx
pipx install andromity
```

---

## ✨ Key Features

<div align="center">
  <img src="vscode-extension/walkthroughs/assets/planning.webp" alt="Live Task Planner & Blueprints" width="100%" />
</div>

### 📝 Live Task Planner & Blueprints
Andromity analyzes your codebase, creates an interactive step-by-step implementation plan, and waits for your approval before writing a single line of code. Review, approve, or skip any step.

---

<div align="center">
  <img src="vscode-extension/walkthroughs/assets/models.webp" alt="396+ Model Support including local Ollama" width="100%" />
</div>

### 🤖 396+ Models — Including Free Local Ollama
Connect Claude 3.7, GPT-4o, Gemini 2.5 Pro, DeepSeek R1, Groq, or run 100% offline with Ollama. Swap models mid-session with `Ctrl+L`.

---

<div align="center">
  <img src="vscode-extension/walkthroughs/assets/trusted.webp" alt="Trust and Workspace Governance" width="100%" />
</div>

### 🔐 Trust Governance — You Are Always in Control

| Mode | Plans | File Writes | Terminal Commands |
|------|-------|-------------|-------------------|
| **SAFE** *(default)* | Approve each | Approve each | Approve each |
| **TRUST** | Approve | Direct | Direct |
| **FULL** | Auto | Direct | Direct |
| **YOLO** | Auto | Silent | Silent |

Nothing runs until you say a folder is trusted. Start in SAFE, move to YOLO when you know what the agent does.

---

## How it compares

| | Andromity | Aider | Cursor | Claude Code |
|--|-----------|-------|--------|-------------|
| Folder trust model | ✅ | ❌ | ❌ | ❌ |
| Permission levels (SAFE → YOLO) | ✅ | ❌ | Partial | ❌ |
| **Built-in cron scheduler** | ✅ | ❌ | ❌ | ❌ |
| **Parallel sessions & subagents** | ✅ | ❌ | ❌ | Partial |
| Inline diff viewer | ✅ | ✅ | ✅ | ✅ |
| Session management + `/undo` | ✅ | ❌ | Partial | ❌ |
| Agent profiles | ✅ | ❌ | ❌ | Partial |
| Local-first / Ollama / BYOK | ✅ | ✅ | ❌ | ❌ |
| MCP support | ✅ | ❌ | Partial | ✅ |
| VS Code Extension | ✅ | ❌ | ✅ | ✅ |

---

## ⏰ Cron Scheduler — AI That Works While You Sleep

No other AI coding agent has this. Open `/cron` inside Andromity, write your task, set a schedule — and the agent executes it autonomously on a timer while you're away.

```bash
# Example: auto-run test suite and fix failures every night at 2 AM
/cron  →  "run pytest, fix any failing tests, commit the fix"  →  0 2 * * *
```

Jobs persist in `.andromity/crons.json` per project. Use FULL or YOLO mode for fully unattended overnight runs. Wake up to commits already made.

---

## 🤖 Parallel Sessions & Subagents

Spawn background subagents for parallel workstreams without interrupting your main session. Example: while one subagent researches an unfamiliar library, another implements a feature, and you review the plan in the main session — all simultaneously.

```
Main session      → Plan & implement Feature A
Subagent 1        → Research the best auth library
Subagent 2        → Write unit tests for Feature B
```

Switch between all sessions with `Ctrl+O`. Every session has its own context, history, and file change log. `/undo` reverts only the current session's changes.

---

## What's inside the terminal workspace

> The VS Code extension and the terminal share the same agent core. The terminal workspace gives you the raw power.

<div align="center">
  <video src="https://github.com/user-attachments/assets/5203a1d8-9c6d-4d8f-bee3-7b4316f6fb22" autoplay loop muted playsinline width="100%"></video>
</div>

**Profiles.** Switch what the agent is trying to do mid-session.
- `builder` — plans first, then implements
- `coder` — implements directly, no planning phase
- `reviewer` — read-only, produces findings
- `planner` — plans only, touches nothing

**MCP support.** Drop a `mcp.json` in your project. Tool schemas load on demand — keeps token use sane with 50+ tools connected.

**Sessions.** Everything is saved. `/sessions` or `Ctrl+O` to switch. `/compact` when context gets heavy. `/undo` to revert the last turn and all its file changes.

**Headless / scripted runs.**
```bash
andromity run "add error handling to auth.py"
andromity run "refactor this to async" --yes      # auto-approve everything
andromity run "review session.py" --dry-run       # see what it would do
```

**Model-agnostic.** LiteLLM under the hood. Anthropic, OpenAI, Gemini, Groq, OpenRouter, Ollama, NVIDIA NIM. Swap mid-session with `Ctrl+L`.

---

## Privacy

Your code goes to one place: the LLM provider you configure. Not us.

- API keys live in `~/.andromity/config.toml` — encrypted locally
- Sessions stored locally in `~/.andromity/sessions/`
- Opt out of telemetry: `export DO_NOT_TRACK=1`

---
## Star History

<a href="https://www.star-history.com/?repos=agenticmarket%2Fandromity&type=date&legend=top-left">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=agenticmarket/andromity&type=date&theme=dark&legend=top-left" />
   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=agenticmarket/andromity&type=date&legend=top-left" />
   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=agenticmarket/andromity&type=date&legend=top-left" />
 </picture>
</a>

---

## Changelog

See [CHANGELOG.md](CHANGELOG.md) for detailed release history and version notes.

---

## Contributing

Open an issue or PR. Honest feedback and bug reports are more useful than feature requests right now.

See [CONTRIBUTING.md](CONTRIBUTING.md) for project layout and dev setup.

**MIT** — see [LICENSE](LICENSE).

