Metadata-Version: 2.4
Name: odyss
Version: 0.1.0
Summary: Agent-driven Flutter/iOS verification for AI coding assistants
Requires-Python: >=3.14
Requires-Dist: pydantic>=2.0
Description-Content-Type: text/markdown

# Odyss CLI

Install once, then init any Flutter project with one command.

## Flutter developer (target UX)

```bash
cd my-flutter-app

# One command — no paths, no clone required (once published to PyPI)
uvx odyss init
```

Set LLM API key(s) — at minimum Groq (free at [console.groq.com](https://console.groq.com)). Optional fallbacks when Groq rate-limits: `OPENROUTER_API_KEY`, `GEMINI_API_KEY`. Export or add to `.env` in the project root:

```bash
export GROQ_API_KEY=gsk_...
# optional 429 fallbacks:
# export OPENROUTER_API_KEY=sk-or-...
# export GEMINI_API_KEY=...
```

Then open the project in **VS Code** (Copilot chat) or **Cursor** (Agent) → *"Verify the auth flow"*.

Reports appear at `.odyss/reports/latest.html`.

## Alternative: install the tool globally

```bash
uv tool install odyss
cd my-flutter-app
odyss init
```

## Odyss platform development (this repo)

```bash
cd cli
uv sync
uv run pytest
uv build --wheel --no-build-isolation   # bundles platform into the wheel
```

Local test before PyPI publish:

```bash
cd my-flutter-app
uvx --from /path/to/Odyss/cli odyss init
```
