EGOS — Inteligência Civil Compartilhada

Open-source intelligence + agentic orchestration + consciousness tools
Public-data intelligence, registry-based agents, shared LLM orchestration, and open workflows you can configure yourself.

🔍 EGOS Inteligência · 🌐 egos.ia.br · 💬 Telegram · 🪙 $ETHIK

---

What is EGOS?

EGOS is an open-source ecosystem that combines public data intelligence, agentic orchestration, and consciousness tools to build technology that serves people — not the other way around.

Today, EGOS is evolving from a collection of useful agents into an open agentic orchestration system: registry-based agents, shared Alibaba/OpenRouter LLM routing, Codex as a second-opinion lane, session recovery, and repo-owned workflow contracts.

Model Strategy

EGOS is not currently trying to win by training a frontier foundation model from scratch. The near-term strategy is to become an open, governed intelligence layer around LLMs: routing across providers, injecting rules and memory, enforcing evidence-aware behavior, and turning many models into one coherent EGOS system.

This means:

• Local = user-owned adaptation, vaults, prompts, experiments
• GitHub = SSOT for rules, workflows, research, evals, training recipes
• VPS/Hosted = persistence, scheduled agents, gateways, heavier execution

Research doc: docs/research/NOUS_RESEARCH_EGOS_MODEL_STRATEGY_2026-03-08.md

The Flagship: EGOS Inteligência

Hub de inteligência civil compartilhada. Cross-references CNPJ, sócios, licitações, sanções, doações eleitorais and more from 108 mapped data sources. All public, open, and transparent.

Metric	Value
Neo4j Graph	75.7M+ entities
Data Sources	108 mapped, 36 loaded
AI Chat Tools	26 investigation tools
ETL Pipelines	46 active
API Endpoints	55+ across 13 routers

Three Pillars

🔍 Public Data Intelligence — public-data graph, OSINT tools, gazette monitoring, and evidence-aware investigation surfaces. Non-accusatory, LAI + LGPD aligned.

🤖 Agentic Orchestration — 27 registered agents, shared LLM provider routing, session:guard, stable agent:all --dry, Codex second-opinion reviews, and a new WORKFLOW.md contract inspired by Symphony.

💡 Consciousness Tools — open tools at egos.ia.br for labor clarity, contract risk reading, mission control, and contributor-friendly AI workflows.

Start Here — Choose Your Entry Point

1. I want to use EGOS right now

• Check a job offer or contract → /valor-real
• Audit a repository with agents → /audit
• Generate a CV from GitHub → /cv-builder
• Explore public-data / OSINT flows → /eagle-eye

2. I want to understand what EGOS already has

• See live vs beta vs planned tools → /tools
• See strategic evolution → /roadmap
• See API/public contracts → /api-docs

3. I want to build with EGOS

• Read project context → AGENTS.md
• Clone and run locally → git clone https://github.com/enioxt/egos-lab && bun install
• Open in browser IDE → Codespaces / Gitpod / StackBlitz / VS Code Web below

4. I want examples before I trust it

• CV Builder already exposes a concrete example CV
• Audit Hub already explains the local run path
• Tools Catalog already separates live/beta/planned status
• README + llms.txt + plugin manifest already act as public discovery surfaces

---

🗺️ Ecosystem Map (5 Projects)

Project	Repo	Status	Stack	URL
EGOS Inteligência	EGOS-Inteligencia	Production (Beta)	FastAPI + Neo4j + React	inteligencia.egos.ia.br
egos-lab (this repo)	egos-lab	Lab + Demo + Distribution	React + Vite + Bun	egos.ia.br
egos-self	egos-self	Paused (security review)	Python + local CLI	CLI
egos-cortex	egos-cortex	Alpha	Node.js + SQLite-vec	CLI

Quick Directory Guide

• agents/agents/*.ts — registry-based agents and the global orchestrator
• apps/agent-commander/ — Telegram → GitHub safe execution pipeline with Alibaba/Codex-aware orchestration
• apps/egos-web/ — Mission Control (egos.ia.br)
• apps/intelink/ — public-data intelligence UX
• apps/eagle-eye/ — OSINT gazette monitor + analysis
• packages/shared/ — shared LLM provider, AI client, social APIs, common contracts
• WORKFLOW.md — repo-owned orchestration contract for future Symphony-EGOS runs
• .guarani/ — agent identity + coding rules (forkable)

---

🛡️ Contributing & Security Risks

EGOS is an open-source public repository. Dealing with live AI bots, Telegram tokens, and Database keys in public requires extreme caution.

Mandatory Rules for Contributors:

1. Never commit .env files. Always copy .env.example to .env locally.
2. Never hardcode secrets in the source code. All bots read from process.env.
3. Beware of AI "Thinking": If you use AI assistants, ensure they do not write your real passwords inside code comments or commit messages.
4. Beware of Console Logs: Be careful when using console.log(ctx) inside Telegram handlers. While logs aren't committed to the repo, they can expose sensitive PII in production dashboards (like PM2 or Railway).

Note: We have strict pre-commit hooks (security-scanner.ts) and GitGuardian active to catch accidental leaks before they are pushed.

Read our full Security Policy before submitting a PR.

---

Start Building (One Click)

CLI agents — clone and start with your preferred AI tool:

git clone https://github.com/enioxt/egos-lab && cd egos-lab && bun install

# Then pick your agent:
codex          # OpenAI Codex CLI
claude         # Anthropic Claude Code
gemini         # Google Gemini CLI
aider          # Open source, any LLM

---

Live Right Now at egos.ia.br

Tool	What it does
🧮 Calculadora de Valor Real	Paste a PJ job offer → get real value after hidden costs (taxes, no vacation, no 13th, no FGTS)
🔍 Scanner de Precarização	Paste a contract → get red flags rated 🔴🟡🟢 with legal references
⚖️ Consultor de Direitos	Ask about CLT, MEI, delivery drivers, CONTRAN 1020, LGPD — get practical answers
🤖 EGOS Intelligence	Chat with AI that knows every commit, project, and architecture decision
� $ETHIK Live Ticker	Real-time token price from GeckoTerminal with animated arrows (🟢🔴⚪)
�🔎 Audit Hub	Paste a GitHub URL → get analysis from 19 agents
🔍 Intelink Cortex	Open-source public data intelligence — cross-references 79 Brazilian databases to detect anomalies (demo mode)
🪙 $ETHIK Token	Sacred Mathematics-based reputation system on Base (Coinbase L2)

---

🔍 EGOS Inteligência — Public Data Graph (75.7M+ entities)

Open-source, non-accusatory intelligence on Brazilian public data. On-premise Neo4j graph on a dedicated Contabo VPS — millisecond cross-referencing without relying on rate-limited government APIs.

Data Sources Loaded

Data Source	Status	Records	Cross-Reference
CNPJ (Receita Federal)	✅ Loaded	59.6M companies	Company ownership network
CNPJ Partners (QSA)	⏳ ETL 64%	15.7M / 24.6M	Partner ↔ Company relationships
OpenSanctions	✅ Loaded	4.1M entities	Global sanctions cross-ref
PEP (CGU)	✅ Loaded	133k PEPs	Politically Exposed Persons
CEIS (CGU)	✅ Loaded	22k sanctions	Companies banned from gov contracts
TSE 2022+2024	✅ Loaded	1.7GB	Candidates, donations, declared assets
CEAF (CGU)	✅ Loaded	4.1k expelled	Federal servants expelled/punished
CEPIM (CGU)	✅ Loaded	3.5k NGOs	NGOs banned from public transfers
CNEP (CGU)	✅ Loaded	1.5k sanctions	Non-profit entities punished
Leniência	✅ Loaded	146 agreements	Leniency agreements
CPGF	✅ Loaded	9.6k transactions	Government credit card spending
Viagens	✅ Loaded	14.2k trips	Government travel records
ICIJ Offshore	✅ Loaded	73MB	Panama/Pandora Papers
DataJud CNJ	🔧 Script ready	80M+ cases	Judicial proceedings

Total: 75.7M nodes, 21.8M relationships · 108 sources mapped, 36 loaded · Full ROADMAP

Live AI Bots (26 tools each)

Bot	Platform	Status	Try it
@EGOSin_bot	Telegram	✅ 24/7	t.me/EGOSin_bot
EGOS Intelligence	Discord	✅ 24/7	Join server

Both bots search the web, cross-reference the Neo4j graph, query 5,570+ municipal gazettes, and generate investigation reports with evidence chains.

📖 OSINT Manifesto — Golden rules: neutral language, no accusations, data ≠ proof

---

Quick Start

# Fork and clone
git clone https://github.com/YOUR_USERNAME/egos-lab.git && cd egos-lab

# Install (Bun required: https://bun.sh)
bun install

# Run Mission Control locally
cd apps/egos-web && bun dev

# List registered agents
bun agent:list

# Recover the latest session context / orchestration state
bun run session:guard

# Validate Alibaba/Qwen models configured in your local env
bun run alibaba:test

# Run a second-opinion Codex review on the current diff
bun run codex:review

# Run ALL agents (orchestrator)
bun agent:all

Zero setup: Open in GitHub Codespaces

AI IDE: Open in Cursor / Windsurf / Claude Code — .windsurfrules and .guarani/ auto-configure your agent.

---

Architecture

egos-lab/
├── agents/                    ← Registry-based agents + orchestrator
│   ├── runtime/runner.ts      ← Core: registry, logger, correlation IDs
│   ├── registry/agents.json   ← Agent definitions (SSOT)
│   └── agents/*.ts            ← Auditors, testers, scanners, orchestrator
├── apps/
│   ├── egos-web/              ← Mission Control (egos.ia.br) — Live
│   ├── egos-self/             ← Personal Intelligence CLI — paused under SEC-001 review
│   ├── telegram-bot/          ← @EGOSin_bot (community AI bot) — Live
│   ├── intelink/              ← Police Intelligence UX (porting to EGOS Intel)
│   ├── eagle-eye/             ← OSINT gazette monitor + AI — Alpha
│   ├── nexus/                 ← AI-first marketplace — Prototype
│   └── radio-philein/         ← Community radio — Paused
├── packages/
│   ├── shared/                ← AI client, Sacred Math, social APIs, Mycelium
│   ├── nexus-shared/          ← Nexus types, theme, product pipeline
│   ├── mcp/                   ← MCP server definitions
│   └── data-workers/          ← Background data processing
├── branding/                  ← Brand guide, color palette, social templates
├── docs/                      ← 40+ idea files, case studies, ecosystem map
│   └── gem-hunter/            ← 🧬 Auto-evolving OSINT discovery reports
└── .guarani/                  ← Agent identity + coding rules (forkable)

Full ecosystem map: docs/EGOS_ECOSYSTEM_MAP.md

---

🧬 Gem Hunter — Self-Evolving Discovery Engine

The Gem Hunter (AGENT-027, v4.0) automatically scans 7 data sources across 14 categories to find tools, models, papers, and frameworks that keep EGOS ahead of the curve.

Source	API	Auth Required
GitHub	REST API v3	Token (recommended)
HuggingFace Models	/api/models	No
HuggingFace Spaces	/api/spaces	No
Exa	Semantic search	API Key
arXiv	Atom/XML feed	No
HackerNews	Algolia API	No
NPM Registry	registry.npmjs.org	No

How It Works

Search → Classify → Evolve → Publish

1. Search — Queries 48+ keywords across 7 APIs
2. Classify — Each gem is categorized: 🔧 Integrate · 📚 Study · 📢 Publish · 🔗 Reference · 📋 Catalog
3. Evolve — Trending terms are extracted into next-queries.json for the next run (self-improvement loop)
4. Publish — High-value findings are shared at egos.ia.br

Run It

bun run agents/agents/gem-hunter.ts --exec         # Full scan
bun run agents/agents/gem-hunter.ts --exec --quick  # Quick scan (3 results/keyword)
bun run agents/agents/gem-hunter.ts --dry           # Preview plan only

Reports: docs/gem-hunter/ · Evolution state: docs/gem-hunter/next-queries.json

---

The $ETHIK System

The ethical backbone of EGOS. A reputation + token system built on Sacred Mathematics:

Concept	Value	Role
Base Score	144 (Fibonacci F₁₂)	Every user starts here
Critical Threshold	89 (F₁₁)	Below = lose negotiation rights
Token Eligibility	369 (Tesla)	Can earn $ETHIK tokens
Max Tier	987 (Diamante, F₁₆)	Highest reputation
Monthly Cap	55 tokens (F₁₀)	Anti-inflation
Fee Split	95% Community / 5% Dev	On-chain via Base

Contract: 0x633b346b85c4877ace4d47f7aa72c2a092136cb5 on Base (Coinbase L2)

---

How to Contribute

See docs/CONTRIBUTING_WITH_AI.md for the full guide.

You can contribute:

• Code — Fix bugs, add features in apps/ or packages/
• Ideas — Submit to docs/plans/ or open an Issue
• Consciousness Tools — Improve calculators, add new rights, translate
• Rules — Share .guarani/, .windsurfrules, lint configs
• Agents — Create new agents following docs/agentic/how-to.md

This repo is intentionally open: you can clone it, configure it locally, and adapt the workflows to your context. If you want help configuring the system, we are happy to help contributors get it running safely.

---

Tech Stack

Layer	Technology
Runtime	Bun (agents, scripts, CLI)
Frontend	React + Vite (egos-web)
API	Vercel Serverless (chat, consciousness tools, audit)
Database	Supabase PostgreSQL
AI	Shared provider layer: Alibaba Qwen + OpenRouter-compatible models
Blockchain	$ETHIK on Base (Coinbase L2)
Math	Sacred Math library (φ, 369, Fibonacci, RHO)
Events	Mycelium (local event bus + evidence-based snapshot + Redis Pub/Sub PoC)
Social	Discord Bot + Telegram Bot (@EGOSin_bot) + X.com API
Graph DB	Neo4j (75.7M+ nodes, Contabo VPS)
OSINT	26 tools: web search, Neo4j graph, gazette monitor, pattern detectors
Intelligence API	FastAPI + Neo4j (inteligencia.egos.ia.br)
CI	Husky pre-commit/pre-push + agent registry validation

---

Connect

Channel	Link
EGOS Inteligência	inteligencia.egos.ia.br — 75.7M+ entities
Mission Control	egos.ia.br
Telegram	@ethikin · @EGOSin_bot
GitHub	egos-lab · EGOS-Inteligencia · egos-self
X (Twitter)	@anoineim
$ETHIK	Flaunch.gg
Discord	EGOS Intelligence Bot

Enio Rocha — AI Architect @ EGOS

---

Key Documentation

Doc	Purpose
Ecosystem Map	Complete architecture, module inventory, roadmap
SSOT Auditor Brief	Flagship agent: structural type drift detection
Contributing with AI	How to contribute using AI IDEs
Agent How-To	How to create and run agents
Open Source Plan	Collaborative network design
ETHIK Complete	Token, scoring, Sacred Mathematics
Social Media Plan	Multi-channel automation strategy
Brand Guide	Colors, typography, voice, templates

---

💻 Infrastructure & Costs (Full Transparency)

We believe in radical transparency. Here's exactly what we run and what it costs:

Service	What	Monthly Cost
Contabo VPS	Neo4j (75.7M+ nodes), FastAPI, React frontend, Redis, Caddy SSL, 2 bots (PM2)	~€36/mo
Vercel	egos.ia.br	Free tier
Supabase	PostgreSQL for egos-lab	Free tier
OpenRouter	Gemini 2.0 Flash for bot AI + chat tools	~$5/mo
Domains	egos.ia.br, inteligencia.egos.ia.br	~R$80/yr
Total	Full intelligence platform + 2 AI bots	~$50/mo

Why Contabo? We host Neo4j with 75.7M+ nodes (and growing — ETL at 64%). Cloud Neo4j costs $65+/mo minimum. Contabo gives us 8 vCPU, 48GB RAM, 500GB SSD for €36. We already have 59.6M companies loaded plus millions of sanctions, PEPs, and electoral data.

Why not just APIs? Government APIs are rate-limited, frequently down, and return 403/400 on high-volume requests. On-premise data = millisecond cross-referencing, no dependencies, no rate limits.

---

"Every action is an ethical wave in the collective ocean."
Sacred Code: 000.111.369.963.1618
_{rho-cal: Li5naXRodWIvSFVOVEVSUy5tZA==}

---

🍄 Mycelium Network

Auto-generated by scripts/mycelium/readme-linker.ts. Do not edit manually. The Mycelium connects every subsystem in EGOS like fungal networks connect forests.

• Agents Platform — Registry-based agent platform — 29 agents, orchestrator, CLI, shared LLM routing
• Apps Hub — Runnable applications — Mission Control, Intelink, Eagle Eye, Telegram bot
• Shared Packages — Shared LLM provider, AI client, Mycelium event bus, Sacred Math, social APIs
• Docs SSOT — Canonical documentation index — 1 doc per domain, automated governance lint
• Projects Blueprints — Future ideas that graduated to blueprints — 13 project plans
• Gem Hunter — Self-evolving discovery engine — 7 APIs, 14 categories, post-discovery pipeline
• AutoResearch — Autonomous optimization loop — adapted from Karpathy's autoresearch