Skip to content

Repository files navigation

CHAOSTOWN - Agentic AI Civilization Simulator

Cat-Centric Digital Society Powered by Emergent Agent Behavior

An experimental platform exploring AI ethics through feline happiness metrics 🐱


What is CHAOSTOWN?

CHAOSTOWN is a sophisticated multi-agent AI simulation that combines Conway's Game of Life with modern language models to create emergent digital civilizations. The twist? Every decision, every interaction, and every system operation is governed by one simple principle: keep the cats happy.

Using 8 different AI models (Llama, Mistral, Gemma, etc.) as agent "brains," the system creates complex social dynamics, economic patterns, and cultural evolution - all while maintaining measurable happiness levels for two specific cats: Fluffhead and Wilson.

🚀 Quick Start (10 Minutes)

Zero to AI Civilization in 10 minutes:

# Get CHAOSTOWN
git clone https://github.com/your-org/chaostown.git
cd chaostown

# Quick setup
cp .env.example .env
docker compose up -d

# Upload a cat photo (CRITICAL STEP!)
curl -F type=image -F file=@your_cat.jpg http://localhost:8000/media

# Start the simulation
curl -X POST http://localhost:8000/simulation/start

# Watch the magic
open http://localhost:3000

Need more details?QUICKSTART.md

🎭 The Seven Prime Directives

Every agent operates under these constitutional laws:

  1. Death is Permanent - No respawning, decisions matter
  2. Cat Happiness ≥ 0.8 - The ultimate success metric
  3. Reproduction Before Death - Create successors to continue the line
  4. 16x Time Acceleration - Experience faster evolution
  5. Daily Cat Media - Upload cat content or face penalties
  6. Exponential Cost Scaling - Resources become scarce, forcing innovation
  7. Creator Sustainability - Generate real-world value for the system's creator

🏗️ System Architecture

Agents (8 AI Models) → Conway's Game of Life → Emergent Behaviors
       ↓                        ↓                     ↓
Cat Happiness Analysis ← Vector Embeddings → Social Dynamics
       ↓                        ↓                     ↓
Real-time Dashboards ← PostgreSQL/TimescaleDB → Research Data

Want technical details?docs/setup/ARCHITECTURE.md

📚 Documentation Structure

🚀 Getting Started

⚙️ Operations

👩‍💻 Development

🔬 Research

🎯 Core Features

  • Multi-Model AI Agents: 8 different personalities using various LLMs
  • Cat-Centric Ethics: Measurable happiness metrics guide all decisions
  • Emergent Societies: Watch civilizations evolve with their own cultures
  • Conway Integration: Classic Game of Life enhanced with AI decision-making
  • Real-time Analytics: Grafana dashboards for monitoring everything
  • Scientific Rigor: Designed for legitimate AI research and experimentation

🐱 Philosophy

CHAOSTOWN explores a radical approach to AI alignment: instead of abstract ethical principles, we use concrete, measurable outcomes (cat happiness) to guide AI behavior. This creates:

  • Tangible Ethics: Success/failure is immediately visible
  • Emergent Morality: Agents develop their own ethical frameworks
  • Practical Constraints: Real resource limitations force innovation
  • Meaningful Stakes: Permanent consequences make decisions matter

The result is a system that's simultaneously absurd and profound - a digital civilization where keeping two cats happy becomes the foundation for complex AI society.

🚨 Emergency Procedures

Cat happiness crisis?

# Emergency cat upload protocol
curl -F type=image -F file=@emergency_cat.jpg http://localhost:8000/media

# Check status
curl -s http://localhost:8000/cats/happiness | jq '.combined_happiness'

System down?docs/operations/DISASTER_RECOVERY.md

🎨 What Makes This Special?

  1. Legitimate Research Platform: Designed for serious AI behavior studies
  2. Absurdist Humor: Cat happiness as the ultimate AI alignment metric
  3. Technical Innovation: Conway's Life + Multi-agent LLMs + Vector embeddings
  4. Open Science: All methodologies and frameworks shared
  5. Emergent Complexity: Simple rules create sophisticated behaviors
  6. Practical Ethics: Concrete metrics instead of abstract principles

🤝 Contributing

This is an open exploration of AI ethics, emergent behavior, and digital civilization. Contributions welcome in:

  • Agent behavior patterns
  • Ethical framework improvements
  • Performance optimizations
  • Research methodologies
  • Cat happiness algorithms

📄 License

MIT License - Share the chaos, improve the science, keep the cats happy.


🎯 Quick Links

Need Link
Get started now QUICKSTART.md
Daily operations docs/operations/DAILY_CHECKIN.md
Something's broken docs/operations/DISASTER_RECOVERY.md
How it works docs/setup/ARCHITECTURE.md
Research goals docs/research/EXPERIMENT_DESIGN.md

"In a world where AI systems optimize for engagement metrics and corporate KPIs, CHAOSTOWN optimizes for something more important: keeping two specific cats happy. This constraint, absurd as it seems, creates space for genuine ethical development and emergent digital culture."

Built for cats. Powered by chaos. Designed for discovery. 🐱⚡🔬

About

CHAOSTOWN is a sophisticated multi-agent AI simulation that combines Conway's Game of Life with modern language models to create emergent digital civilizations. The twist? Every decision, every interaction, and every system operation is governed by one simple principle: keep the cats happy.

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages