hyperion-chess / README.md
Krissah-code's picture
Add Hyperion-Chess model card
d015030 verified
|
Raw History Blame Contribute Delete
1.42 kB
---
license: apache-2.0
tags:
- chess
- chess-engine
- numba
- nnue
- aichessathon
- game-ai
language:
- en
pipeline_tag: other
---
# Hyperion-Chess
Chess engine for [AI Chessathon 2026](https://aichessathon.com).
## Overview
Hyperion-Chess is a competition-grade Python chess agent combining:
- **Iterative deepening alpha-beta** with quiescence search
- **Numba-jitted PST evaluation** (Phase 1)
- **Micro-NNUE** int8 weights (Phase 3, trained locally on SF-labelled FENs)
- **4-man Syzygy tablebases** for perfect endgames within the 50 MB zip cap
- **Dynamic time management** for 120s + 0.5s control
## Source code
GitHub: [shahaman098/hyperion-chess](https://github.com/shahaman098/hyperion-chess)
## Weights (coming soon)
| File | Description |
|---|---|
| `nnue.npz` | Quantized Micro-NNUE (768→128×2→32→1) |
| Syzygy 4-man | Endgame tablebase (too large for HF; shipped in competition zip) |
## Usage
This is a **competition submission**, not a pip package. The platform imports `agent.get_move(fen, time_left_ms)`.
```python
import agent
move = agent.get_move("rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1", 120_000)
# → "e2e4"
```
## Training
Training scripts live in the GitHub repo under `training/`. Positions may be labelled with Stockfish at train time (allowed by competition rules); only self-trained weights ship in the zip.
## License
Apache 2.0