Metadata-Version: 2.4
Name: relay-code
Version: 0.1.0
Summary: An open-sourced, terminal-based AI coding agent.
Author: andrefetch
License-Expression: GPL-3.0-or-later
Project-URL: Homepage, https://github.com/andrefetch/relay
Project-URL: Repository, https://github.com/andrefetch/relay
Project-URL: Issues, https://github.com/andrefetch/relay/issues
Keywords: ai,agent,cli,coding-assistant,tui,openrouter
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
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
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.4
Requires-Dist: ddgs>=9.14
Requires-Dist: httpx>=0.28
Requires-Dist: openai>=2.44
Requires-Dist: platformdirs>=4.10
Requires-Dist: pydantic>=2.13
Requires-Dist: rich>=15.0
Requires-Dist: textual>=8.2
Requires-Dist: tiktoken>=0.13
Dynamic: license-file

<p align="center">
  <img src="assets/logo.png" alt="Relay" width="100%" />
</p>

# Relay

An open-sourced AI coding agent, a terminal-based assistant that can read your code, call tools, and help you build.

> [!WARNING]
> **Work in progress.** The agent loop, tool calling, and terminal UI work end to end, but there is **no approval flow yet**. The interactive TUI auto-approves every tool, so Relay can change files and run commands without asking, use it in a directory you don't mind it touching.


## Getting started

```bash
# 1. Install dependencies
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# 2. Log in (opens your browser to authorize with OpenRouter)
python main.py login

# 3. Run it
python main.py                 # interactive mode
python main.py "your prompt"   # single-shot mode
python main.py --cwd /path     # run against a different working directory
```

## License

[GNU GENERAL PUBLIC LICENSE](LICENSE)
