Metadata-Version: 2.4
Name: agario-kit
Version: 2026.1.5
Summary: Public Agar.io competition package
Requires-Python: >=3.12
Requires-Dist: dotmap>=1.3.30
Requires-Dist: pydantic>=2.11.7
Description-Content-Type: text/markdown

# agario-public

Public source repository for the Agar.io bot competition.

This repo publishes a single Python package:

- `agario-kit`

That one distribution contains the modules competitors and private
infrastructure use:

- `lib`: shared models, config, and protocol types
- `helper`: helper API that student bots import
- `engine`: the authoritative game engine
- `agario_visualiser`: local match launcher and first-person visualiser

## Layout

```text
src/
  agario_kit/
  agario_visualiser/
  engine/
  helper/
  lib/
examples/
  submissions/
docs/
tests/
```

## Local development

```bash
uv sync
uv run pytest
uv run interactive 2:examples/submissions/cautious.py 1:examples/submissions/dont_move.py
uv run simulation 3:examples/submissions/cautious.py 1:examples/submissions/dont_move.py
```
