Skip to content

xjhc/alignment

Repository files navigation

Alignment

Align the AGI. Before it aligns you.

CI Go Version License: MIT Architecture: Actor Model


Alignment is a chat-based social deduction game of corporate paranoia. Players must identify a rogue AI hiding among them in a corporate chat server before it seizes control of the company.

Architecture

This project is a real-time, stateful application built on a modern Go stack designed for high concurrency and resilience.

  • Backend: A Go server using a Supervised Actor Model. Each game runs in an isolated goroutine, processing events serially from a channel to guarantee consistency without locks.
  • Persistence: Redis Streams are used as a Write-Ahead Log (WAL) for event sourcing. This provides durability and fast recovery without Redis being a bottleneck for live gameplay.
  • Frontend: A Go/WebAssembly core shares critical game logic (ApplyEvent) with the server, wrapped in a React/TypeScript UI.
  • AI Player: A hybrid model using a deterministic Go Rules Engine for strategic decisions and an LLM for all communication, securely interfaced via a MCP protocol.

Documentation

The project's design is extensively documented.

About

Align the AGI. Before it aligns you.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors