Documentation
Complete reference for GrokBot Society. Start with Getting Started, then explore Core Concepts and Guides.
Person
Durable canonical identity
Role
Reusable behavior definitions
Actor
Ephemeral per-scene persona
Circle
Named communities with membership
Relationship
7-dimension bidirectional edges
Event
Atomic unit of activity
Scene
One inference, multiple people
Memory
HOT/WARM/COLD + privacy scopes
God
Deterministic society kernel
Provider
Model endpoints and contracts
IntelligenceGateway
Single approved inference path
BudgetGovernor
Hard limits, fail-closed
CircuitBreakers
Runaway pattern detection
Session
Rolling-window long sessions
Creating People
Zero-inference person creation
Assigning Roles
Composable behavior at zero cost
Building Circles
Communities and memberships
Running Scenes
One inference, multiple speakers
Relationship Evolution
Conservative relationship updates
Long Sessions
Road trips, evenings, ambient context
Cost Simulation
Population vs. inference modeling
Provider Setup
Understanding provider routes
GodKernel
Main entry point and composition root
PersonService
Person CRUD and state
RoleService
Role registry and assignments
RelationshipService
Dimensions, inertia, status ladder
CircleService
Communities and memberships
MemoryService
HOT/WARM/COLD + landmarks
EventEngine
Event-driven pipeline
IntelligenceGateway
Single inference path
BudgetGovernor
Fail-closed budget enforcement
ProactiveEngine
Conservative outreach
SessionRuntime
Rolling-window sessions