Metadata-Version: 2.5
Name: aipyrasechampions
Version: 0.1.0
Summary: A 3D AI racing challenge framework for Python
Author: AIPyRaceChampions contributors
License: MIT
Requires-Python: >=3.10
Provides-Extra: 3d
Requires-Dist: ursina>=7.0.0; extra == '3d'
Description-Content-Type: text/markdown

# AIPyRaceChampions

PythonでAIエージェントを3Dコース上で走らせるレースチャレンジ基盤です。

## Install

```bash
pip install aipyrasechampions
pip install "aipyrasechampions[3d]"  # 3D viewer
```

## Agent API

```python
from aipyrasechampions import Agent, Race, Track

class SimpleAgent(Agent):
    def act(self, observation):
        return {"throttle": 0.8, "steering": 0.0}

race = Race(Track.training_circuit(), SimpleAgent())
for _ in range(1000):
    result = race.step(0.05)
    if result.done:
        break
print(result.lap_time, result.reward)
```

Observationには速度、コース上の進捗、左右の距離センサーが含まれます。Ursinaを追加すると `aipyrace --demo` で3Dデモを起動できます。
