explaingit

yungbilionz/startup-os

0HTMLAudience · pm founderComplexity · 2/5ActiveLicenseSetup · moderate

TLDR

Flask app that runs five parallel AI agents on a startup idea and returns market research, pitch, financials, legal flags, and a score in about 60 to 90 seconds.

Mindmap

mindmap
  root((startup-os))
    Inputs
      Startup idea text
      Groq API key
      Swarms API key
    Outputs
      Market research
      Pitch deck text
      Financial model
      Score out of 10
    Use Cases
      Quick idea validation
      Investor pitch draft
      Solo founder co-pilot
    Tech Stack
      Python
      Flask
      Swarms
      Groq

Things people build with this

USE CASE 1

Generate an investor-ready package for a startup idea in about a minute

USE CASE 2

Build a self-hosted idea validator that scores pitches out of 10

USE CASE 3

Call POST /analyze from another app to get structured business analysis

USE CASE 4

Study the Swarms MixtureOfAgents pattern with a working example

Tech stack

PythonFlaskSwarmsGroqLLaMA

Getting it running

Difficulty · moderate Time to first run · 30min

Needs Python 3.10+, free Groq and Swarms API keys in a .env file, and several pip dependencies installed.

MIT permits commercial use, modification, and distribution with attribution.

In plain English

StartupOS bills itself as an AI co-founder swarm. The pitch in the README is that a single startup idea is sent into the system, five specialized AI agents work on it at the same time, and roughly 60 to 90 seconds later the user gets back what the project calls an investor-ready package with a score out of 10. There is a live demo link on a Render-hosted URL. The five worker agents each have a specific role. A Market Researcher looks at market size, competitors, trends, and risks. A Business Analyst writes the revenue model, pricing, and go-to-market plan. A Pitch Writer produces the investor narrative including a one-liner, the problem, the solution, and the funding ask. A Financial Modeler generates three-year revenue, burn rate, lifetime value, customer acquisition cost, and margins. A Legal Scanner flags legal risks, licenses, intellectual property concerns, and compliance issues. A sixth Director Agent then reads all five outputs and writes the final synthesis along with the score. The project is built on the Swarms Framework using its MixtureOfAgents pattern, which is what lets the five specialists run in parallel and then hands the results to an aggregator. The language model behind every agent is LLaMA 3.3 70B served by Groq, which the README highlights as both fast and free. The backend is Flask, the frontend is plain HTML, CSS, and JavaScript, and configuration goes through a .env file using python-dotenv. Python 3.10 or newer is required. Setup involves cloning the repo, installing dependencies including swarms, flask, flask-cors, groq, python-dotenv, and google-genai, and signing up for two free API keys, one with Groq and one with Swarms. Once both keys are in the .env file inside the startup_os folder, you run python main.py and open localhost on port 5000. The README also documents a single REST endpoint, POST /analyze, that takes a JSON body with an idea field and returns market research, business model, pitch, financial, legal, and final synthesis sections. The README closes with an example for an app that connects African farmers to city buyers, reporting a 56 billion dollar total addressable market, a 5 percent transaction fee model, a 2 million Series A ask, and an 8.5 out of 10 score. The project is MIT-licensed.

Copy-paste prompts

Prompt 1
Install startup-os locally with Python 3.10, set my Groq and Swarms keys in .env, and run main.py
Prompt 2
Add a new agent to startup-os that scores ESG risk and wire it into the Director Agent
Prompt 3
Wrap the POST /analyze endpoint with a Next.js form that streams the result back to the browser
Prompt 4
Swap the Groq LLaMA 3.3 70B backend for Claude Sonnet and compare the score on the same idea
Prompt 5
Show me how to deploy startup-os to Render with environment variables for both API keys
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.