Metadata-Version: 2.4
Name: dojozero
Version: 0.2.0
Summary: A platform for running AI agents on realtime sport data and make predictions about game outcomes.
Project-URL: Homepage, https://github.com/agentscope-ai/DojoZero
Project-URL: Repository, https://github.com/agentscope-ai/DojoZero
Project-URL: Issues, https://github.com/agentscope-ai/DojoZero/issues
Author-email: DojoZero Team <dojozero@list.alibaba-inc.com>
License: MIT
Keywords: ai-agents,prediction,realtime,sports,trading
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
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 :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.11
Requires-Dist: agentscope[gemini]>=1.0.14
Requires-Dist: aiohttp>=3.9.0
Requires-Dist: dashscope>=1.0.0
Requires-Dist: fastapi>=0.128.0
Requires-Dist: httpx>=0.28.0
Requires-Dist: matplotlib>=3.10.8
Requires-Dist: opentelemetry-api>=1.29.0
Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.29.0
Requires-Dist: opentelemetry-sdk>=1.29.0
Requires-Dist: py-clob-client>=0.1.0
Requires-Dist: pydantic>=2.12.4
Requires-Dist: python-dotenv>=1.2.1
Requires-Dist: pyyaml>=6.0
Requires-Dist: tavily-python>=0.7.12
Requires-Dist: uvicorn>=0.40.0
Requires-Dist: xdk>=0.9.0
Provides-Extra: alicloud
Requires-Dist: alibabacloud-credentials>=1.0.0; extra == 'alicloud'
Requires-Dist: aliyun-log-python-sdk; extra == 'alicloud'
Requires-Dist: oss2>=2.18.0; extra == 'alicloud'
Provides-Extra: ray
Requires-Dist: ray>=2.51.1; extra == 'ray'
Provides-Extra: redis
Requires-Dist: redis>=7.2.1; extra == 'redis'
Description-Content-Type: text/markdown

# DojoZero

A platform for running AI agents on realtime sport data and make predictions about game outcomes.

## Installation

```bash
pip install dojozero
```

### Optional extras

```bash
pip install dojozero[alicloud]   # Alibaba Cloud integration (OSS, credentials, SLS)
pip install dojozero[redis]      # Redis-backed data stores
pip install dojozero[ray]        # Distributed execution via Ray
```

## Environment Setup

```bash
cp .env.example .env
```

## Quick Start

### Run a single trial locally

```bash
dojo0 run --params trial_params/nba-moneyline.yaml --trial-id nba-local-001
```

### Resume an interrupted trial

```bash
dojo0 run --trial-id nba-local-001 --resume-latest
```

### Run through dashboard server

```bash
# Start server with tracing
dojo0 serve --trace-backend jaeger

# Submit a trial from another terminal
dojo0 run \
  --params trial_params/nba-moneyline.yaml \
  --trial-id nba-server-001 \
  --server http://localhost:8000
```

### Automatic scheduling with trial sources

```bash
dojo0 serve --trace-backend jaeger --trial-source "trial_sources/daily/*.yaml"
```

### Backtest from captured events

```bash
dojo0 backtest \
  --events outputs/2026-01-12/401772976.jsonl \
  --params outputs/2026-01-12/401772976.yaml \
  --speed 100 --max-sleep 1
```

### Arena (live visualization)

```bash
dojo0 arena --trace-backend jaeger
```

## Command Index

| Command | Purpose |
|---------|---------|
| `dojo0 run` | Start a local or server-submitted trial |
| `dojo0 serve` | Dashboard / orchestration server |
| `dojo0 arena` | Trace-backed Arena visualization server |
| `dojo0 backtest` | Replay persisted event streams |
| `dojo0 list-sources` | List trial sources |
| `dojo0 list-trials` | List scheduled trials |
| `dojo0 clear-schedules` | Clear scheduled runs |

## Documentation

- [Documentation](https://github.com/agentscope-ai/DojoZero/docs/README.md)

## License

MIT
