Skip to content

abkuut/bathhack26

Repository files navigation

CL.AI 🖥️

Train your Linux and Git command skills in a fast-paced terminal game. Built at BathHack 26.

🎮 How to play

  1. Enter your name and pick a difficulty — 1x Dev, 10x Dev, or 100x Dev
  2. An AI generates a set of terminal challenges based on your difficulty
  3. You get a live terminal inside a sandboxed Docker container
  4. Complete the objective before the timer runs out
  5. Score is based on speed, difficulty, and how many hints you used

⚙️ Setup

Prerequisites: Node 18+, Python 3.11+, Docker

# Frontend
npm install
npm run dev

# Backend (separate terminal)
cd backend
pip install -r requirements.txt
uvicorn main:app --reload

The Docker image builds automatically on first launch.

🛠️ Stack

  • React 19 + TypeScript + Vite
  • FastAPI + Docker SDK
  • xterm.js (live terminal over WebSocket)
  • OpenRouter (LLM challenge generation)

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors