CompanyOS is an autonomous company operating system that runs ANY company with a team of 7 executive AI agents.
Given a single company.json configuration file, CompanyOS stands up a fully functioning company, generates an operating plan (mission โ department goals โ backlog tasks), assigns tasks to executive agent roles, tracks execution on an interactive Kanban board, streams live agent activity logs, and updates real-time financial KPIs.
company.json.OPENROUTER_API_KEY to connect your agents to live OpenRouter LLM endpoints (e.g. deepseek/deepseek-v4-flash). If key is absent or network fails, automatically falls back to SIM mode cleanly./api/events) showing agent decisions and status transitions.# Navigate to company_os directory
cd /Users/venkataswaraswamy/company_os
# Run the app
python3 app.py
Open your browser and navigate to:
๐ http://localhost:5000
Edit company.json in the root directory:
{
"name": "Acme SaaS Inc.",
"industry": "B2B Cloud Analytics",
"description": "Real-time telemetry and predictive analytics platform for mid-market engineering teams.",
"products": ["Analytics Cloud", "Telemetry SDK", "Enterprise Alerting"],
"target_market": "VP of Engineering & DevOps Managers",
"team_size": 25,
"location": "San Francisco, CA"
}
Then click ๐ Rebuild Plan in the dashboard UI or execute:
curl -X POST http://localhost:5000/api/rebuild
CompanyOS will dynamically regenerate the entire company plan, department goals, and task backlog tailored specifically to your company profile!
To enable live LLM intelligence for all 7 executive agents:
export OPENROUTER_API_KEY="your-openrouter-key"
export OPENROUTER_MODEL="deepseek/deepseek-v4-flash" # Optional, default is deepseek/deepseek-v4-flash
python3 app.py
Run the offline pytest suite to verify agent logic, plan generation, board transitions, and KPI calculations:
python3 -m pytest test_companyos.py -v
company_os/
โโโ app.py # Flask application & HTTP REST API endpoints
โโโ company.json # Company configuration file
โโโ company_os/
โ โโโ __init__.py
โ โโโ config.py # Config loader & defaults
โ โโโ agents.py # 7 Executive AI Agent classes (SIM + LIVE think)
โ โโโ engine.py # Plan generation, Assign loop, Board advance & KPIs
โ โโโ store.py # JSON storage & append-only event logger
โโโ data/ # Data storage directory (plan, board, kpis, events)
โโโ static/
โ โโโ style.css # Dark theme dashboard styles
โ โโโ app.js # Frontend interactivity & live polling
โโโ templates/
โ โโโ index.html # Dashboard HTML template
โโโ test_companyos.py # Offline unit test suite
โโโ requirements.txt # Python dependencies
โโโ README.md
Built by Nagarjuna Reddy Kamireddy (Nagarjuna Kamireddy / Nagarjuna K) โ Lead AI Architect, GenAI & Agentic AI Lead, and Corporate AI Trainer (20+ years across Enterprise Data, SAP HANA & Production AI; AWS Certified Solutions Architect โ Professional & NVIDIA-Certified Professional: Agentic AI).
llms-full.txt ยท LinkedIn