Metadata-Version: 2.4
Name: openagentic-ai
Version: 0.2.2
Summary: Powerful claude code open source alternative. AI coding assistant powered by Abdel-Hazim Lawani — use it in any folder
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: langgraph>=0.2.0
Requires-Dist: langchain>=1.2.13
Requires-Dist: langchain-core>=1.2.22
Requires-Dist: langchain-community>=0.4.1
Requires-Dist: langchain-together
Requires-Dist: langchain-groq
Requires-Dist: langchain-mistralai
Requires-Dist: langchain-google-genai
Requires-Dist: tavily-python>=0.7.23
Requires-Dist: python-dotenv
Requires-Dist: rich>=13.0
Requires-Dist: langfuse>=2.0.0

# openagentic-ai

**Powerful open-source alternative to Claude Code.** An AI coding assistant that works in any folder, powered by your own API keys.

```bash
pip install openagentic-ai
```

---

## What it does

`open-code` is a terminal-based AI agent that reads, writes, and edits your code, runs shell commands, searches the web, and navigates your entire codebase — all from a single command.

```bash
cd my-project
open-code "add a dark mode toggle to the navbar"
```

---

## Features

- **Multi-provider** — bring your own API key (Together, Groq, Mistral, Gemini, OpenRouter)
- **Full file access** — create, read, edit, delete files and directories
- **Shell execution** — run any command directly in your project folder
- **Codebase search** — glob patterns, regex grep across all files
- **Internet search** — built-in Tavily-powered web research
- **Three agent modes** — `ask`, `auto`, `plan`
- **Session memory** — context is persisted and trimmed intelligently across turns
- **Rich TUI** — beautiful terminal interface with live streaming output

---

## Quick start

### 1. Install

```bash
pip install openagentic-ai
```

### 2. Configure your API key

Create a `.env` file in your project folder (or home directory):

```env
# Pick one provider — the first key found is used

TOGETHER_API_KEY=your_key_here
# GROQ_API_KEY=your_key_here
# MISTRAL_API_KEY=your_key_here
# GEMINI_API_KEY=your_key_here
# OPENROUTER_API_KEY=your_key_here
```

Get a free key:
- [Together AI](https://api.together.xyz/settings/api-keys)
- [Groq](https://console.groq.com/keys)
- [Mistral](https://console.mistral.ai/api-keys)
- [Gemini](https://aistudio.google.com/app/apikey)
- [OpenRouter](https://openrouter.ai/settings/keys)

### 3. Run

```bash
cd your-project
open-code
```

Or pass a query directly:

```bash
open-code "refactor the auth module to use JWT"
open-code --mode plan "migrate the database to PostgreSQL"
```

---

## Supported providers & default models

| Provider | Default model |
|---|---|
| Together AI | `Qwen/Qwen3-Coder-Next-FP8` |
| Groq | `moonshotai/kimi-k2-instruct` |
| Mistral | `codestral-latest` |
| Gemini | `gemini-2.5-pro-preview-03-25` |
| OpenRouter | `kwaipilot/kat-coder-pro-v2` |

Override the model for any provider:

```env
TOGETHER_MODEL=meta-llama/Llama-3-70b-chat-hf
GROQ_MODEL=llama3-70b-8192
GEMINI_MODEL=gemini-2.0-flash
```

---

## Agent modes

| Mode | Behavior |
|---|---|
| `auto` *(default)* | Plans, edits files, and runs commands autonomously |
| `ask` | Read-only — answers questions and explains code, no file changes |
| `plan` | Produces a step-by-step plan and waits for your approval before acting |

```bash
open-code --mode ask "how does the authentication flow work?"
open-code --mode plan "add Stripe payment integration"
```

---

## Environment variables

```env
# Provider API keys (first found is used)
TOGETHER_API_KEY=
GROQ_API_KEY=
MISTRAL_API_KEY=
GEMINI_API_KEY=
OPENROUTER_API_KEY=

# Optional: override default model per provider
TOGETHER_MODEL=
GROQ_MODEL=
MISTRAL_MODEL=
GEMINI_MODEL=
OPENROUTER_MODEL=

# Optional: show full LLM context on each call (debug)
OPENCODE_SHOW_CONTEXT=1

# Optional: Tavily key for internet search
TAVILY_API_KEY=
```

---

## Requirements

- Python >= 3.10
- A valid API key for at least one supported provider

---

## License

MIT — built by Abdel-Hazim Lawani
