Metadata-Version: 2.4
Name: odyss
Version: 0.1.2
Summary: Agent-driven Flutter/iOS verification for AI coding assistants
Project-URL: Homepage, https://github.com/shuchitajain/Odyss
Project-URL: Repository, https://github.com/shuchitajain/Odyss
Project-URL: Issues, https://github.com/shuchitajain/Odyss/issues
Author: Shuchita Jain
License: MPL-2.0
Keywords: agent,ai,automation,flutter,ios,mcp,simulator,testing,verification
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Framework :: Pydantic
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Testing
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
```
