| title | WorldState |
|---|---|
| emoji | 🌐 |
| colorFrom | blue |
| colorTo | indigo |
| sdk | docker |
| app_port | 7860 |
| pinned | false |
| license | mit |
| short_description | open-source intelligence platform |
open-source intelligence platform.
WorldState continuously estimates the current state of the world using publicly available information and generates intelligence snapshots describing what changed, why it matters, who is affected, and what risks are emerging.
Note
This project is a complete rewrite extension of the original GlobalNewsTracker repository, introducing multi-polar intelligence analysis, vector-based event clustering, dynamic market feedback loops, and graph-based chokepoint diagnostics.
- Docker & Docker Compose
- Go 1.23+ (for local backend development)
- Python 3.11+ (for local AI development)
- Node.js 20+ (for local frontend development)
# Copy environment variables
cp .env.example .env
# Start everything
docker compose upServices will be available at:
| Service | URL |
|---|---|
| Frontend | http://localhost:3000 |
| Go Backend API | http://localhost:8080 |
| Python AI API | http://localhost:8000 |
| Meilisearch | http://localhost:7700 |
| NATS Monitor | http://localhost:8222 |
| PostgreSQL | localhost:5432 |
| Redis | localhost:6379 |
| Layer | Technology |
|---|---|
| Frontend | Next.js 16, TypeScript, Tailwind CSS |
| Backend API | Go, Chi Router |
| AI Layer | Python, FastAPI, Gemini AI Studio |
| Primary DB | PostgreSQL 16 |
| Graph DB | Apache AGE (PostgreSQL extension) |
| Search | Meilisearch |
| Cache | Redis 7 |
| Messaging | NATS with JetStream |
| Infrastructure | Docker Compose |
WorldState/
├── frontend/ # Next.js dashboard
├── backend/ # Go API & services
├── python/ # Python AI layer
├── infrastructure/ # Database configs
├── docs/ # Documentation
└── docker-compose.yml
- Events — Everything meaningful becomes an event (sanctions, elections, disasters)
- Entities — World objects (countries, companies, people, commodities)
- Relationships — How entities connect (supplies, sanctions, allies_with)
- World State — Continuously updated risk model of the world
- Intelligence — Generated insights from the world state
- docs/ARCHITECTURE.md — System design
- docs/DATA_MODEL.md — Data schemas
- docs/ROADMAP.md — Development phases
- docs/CONTRIBUTING.md — How to contribute
- docs/SETUP.md — Local development guide
MIT