https://github.com/gbtami/isaac
Isaac is a coding client and agent implementing the Agent Client Protocol (ACP)
https://github.com/gbtami/isaac
acp agent client pydantic-ai
Last synced: 4 months ago
JSON representation
Isaac is a coding client and agent implementing the Agent Client Protocol (ACP)
- Host: GitHub
- URL: https://github.com/gbtami/isaac
- Owner: gbtami
- License: mit
- Created: 2025-11-03T12:56:46.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-02-09T15:35:15.000Z (4 months ago)
- Last Synced: 2026-02-09T16:34:51.102Z (4 months ago)
- Topics: acp, agent, client, pydantic-ai
- Language: Python
- Homepage:
- Size: 1.57 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# 🍏 Isaac ACP 🍏 (`isaac-acp`)
[](https://pypi.org/project/isaac-acp/)
[](https://github.com/gbtami/isaac/actions/workflows/lint.yml)
[](https://github.com/gbtami/isaac/actions/workflows/test.yml)
Isaac is an ACP-compliant coding agent and reference CLI client.
- Agent implementation: `isaac.agent`
- Client REPL implementation: `isaac.client`
- Protocol: [Agent Client Protocol (ACP)](https://agentclientprotocol.com/protocol/)
> Since Newton discovered gravity, everything's been going downhill.
## Installation
```bash
pip install isaac-acp
```
## Quickstart
Run the agent:
```bash
isaac
```
Run the bundled client against the bundled agent:
```bash
python -m isaac.client isaac
```
Or when developing from source:
```bash
uv run python -m isaac.client uv run isaac
```
## Configuration
Isaac loads environment variables from:
1. `/isaac/.env` (via `platformdirs`; Linux example: `~/.config/isaac/.env`)
Common variables:
- `OPENROUTER_API_KEY` (or provider-specific model keys)
- `ISAAC_ACP_STDIO_BUFFER_LIMIT_BYTES` (optional ACP stdio buffer override)
## Features
- ACP 0.8 session config options for mode/model selection
- Prompt turns, tool calls, filesystem and terminal ACP flows
- Interactive client slash commands (`/mode`, `/model`, `/status`, `/usage`)
- MCP server config forwarding from the client to the agent
## Development
```bash
uv pip install -e .
uv run ruff format .
uv run ruff check .
uv run mypy src tests
uv run pytest
uv build --wheel --sdist
```