RimTown – AI Town Simulation
AI Town Simulation · v0.1.0 · Open Source

RimTown

// EVERY RESIDENT IS AN AUTONOMOUS AI AGENT

A RimWorld-inspired simulation where AI agents live, work, gossip, and form relationships—powered by large language models and running entirely in your browser.

▶ GET STARTED EXPLORE FEATURES
RIMTOWN // LIVE VIEW DAY 1
LIVE SIM
Elara harvested crops at the farm Dax told Mira a secret about Gorn Dr. Yeva healed Ruben‘s broken arm ⚡ Flash flood alert — all agents evacuating Lars and Noa became close friends Chef Balu prepared smoked rabbit stew 🔬 Dr. Sable completed research on batteries Elara harvested crops at the farm Dax told Mira a secret about Gorn Dr. Yeva healed Ruben‘s broken arm ⚡ Flash flood alert — all agents evacuating Lars and Noa became close friends
01 /

Core Features

🧠
AUTONOMOUS AI AGENTS

Every resident has personality traits, memories, moods, and psychological needs. They think, feel, and act independently using LLM reasoning.

💬
SOCIAL SIMULATION

Agents chat, gossip, form friendships, rivalries, and romantic relationships. Watch a living social network evolve organically over time.

⚒️
JOB SYSTEM

RimWorld-inspired jobs: farming, mining, cooking, crafting, doctoring, research, and more. Every agent finds their role in the colony.

🌩️
DYNAMIC EVENTS

Random events, changing seasons, and emergencies reshape the town’s daily life. No two simulations are ever the same.

💾
MEMORY & RELATIONSHIPS

Agents remember every interaction and form lasting opinions. A grudge from last season can shape today’s decisions.

🖥️
WEB VISUALIZATION

Real-time browser-based town visualization. Watch your colony breathe at localhost:8000.

02 /

Meet the Residents

Sample AI agents from a running simulation. Each one has a unique life story, set of skills, and network of relationships.

ACTIVE
Elara Voss
// FARMER · HERBALIST
Kind Hardworking Introverted
MOOD ▸ CONTENT
ACTIVE
Dax Orren
// MINER · SCOUT
Reckless Loyal Curious
MOOD ▸ STRESSED
ACTIVE
Dr. Yeva Sable
// DOCTOR · RESEARCHER
Analytical Empathetic Stubborn
MOOD ▸ FOCUSED
RESTING
Balu Chen
// COOK · CRAFTER
Cheerful Creative Gossiper
MOOD ▸ HAPPY
03 /

Architecture

rimtown/
├── core/           # Simulation engine (world, time, events)
├── agents/         # AI agent system (personality, memory, behavior)
├── social/         # Social interactions (chat, gossip, relationships)
├── jobs/           # Job and economy system
├── town/           # Town map and locations
├── llm/            # LLM integration for agent conversations
├── web/            # Web visualization frontend
└── config/         # Town and agent configurations
04 /

Quick Start

01
Install Dependencies

Clone the repo and install the required Python packages.

# Clone the repository
git clone https://github.com/virus11456/RimTown
cd RimTown

# Install dependencies
pip install -r requirements.txt
02
Configure Your LLM Key

Set your API key in the .env file. Supports Anthropic Claude and OpenAI.

# .env
ANTHROPIC_API_KEY=your-key-here
# or
OPENAI_API_KEY=your-key-here
03
Run the Simulation

Launch the engine and open your browser to watch the town come alive.

python -m rimtown.main

# Open browser at
http://localhost:8000
04
Customize Your Town

Edit town layout and residents using simple YAML config files.

config/town.yaml # Town map & settings
config/residents.yaml # Agent personalities & jobs
05 /

Configuration

LLM PROVIDERS
ANTHROPIC_API_KEY Claude models
OPENAI_API_KEY GPT models
YAML CONFIG FILES
town.yaml Map, locations, season
residents.yaml Agents, traits, jobs
▸ OPEN SOURCE · FREE TO USE

Build Your
AI Colony

Fork, modify, and run your own town full of thinking, feeling AI citizens.

▶ VIEW ON GITHUB
返回頂端