Open Source · v2.6.0 · MIT License

The scaffolder that checks GitHub Issues
before writing a single line of code.

Scans 15–20 real repos, mines their Issues and active forks, then builds a scaffold that already knows the traps.

Get started free → View on GitHub
$ pip install genesis-architect
terminal — genesis init "a FastAPI task queue with Celery and Redis"
Genesis Architect in action - NLU, Fork Analysis, Vault cache hit
15–20Repos scanned
50Issues per repo
3Active forks analyzed
8Workflow phases
316Tests passing
500Vault entry cache
How it works

Research first. Then build.

Every other scaffolder starts from a template. Genesis starts from production data.

Step 1
🔍

Scan real repos

Finds 15–20 GitHub repos building exactly what you described. Ranks by stars and active fork activity.

Step 2
⚠️

Mine their Issues

Reads up to 50 closed bug Issues per repo. Extracts recurring errors, security patches, architecture regrets.

Step 3
🧬

Synthesize the ecosystem

Builds the "wise average" — what successful projects converge on — not just a copy of one repo.

Step 4
🏗️

Generate + validate

Creates scaffold with tests and CI/CD. Runs a smoke test. Never declares success without exit code 0.

What's inside

Not a template. A research pipeline.

Built for developers who've been burned by boilerplate that doesn't survive contact with production.

🔬

Real Issue Mining

Reads closed bug issues from production repos. Finds the feedparser hang, the Redis connection leak, the Celery task that silently drops — before you write the code.

🍴

Smart Fork Analysis NEW

Finds the top 3 active forks ranked by merged PRs in the last 6 months — not stars. Extracts their bug fixes and incorporates them into your pitfall list.

🗄️

Knowledge Vault NEW

Caches solutions locally with a 6-month TTL and LRU eviction at 500 entries. Runs fast on repeat projects. Falls back to Stack Overflow on cache miss.

💬

Natural Language Choices NEW

Say "I want the simple one" instead of typing A. Genesis maps natural language to architecture choices — no memorizing option letters.

🤖

Companion Mode NEW

Run genesis companion after scaffolding. Stays active, answers questions about your project, detects when you've moved on to something new.

🔌

Works with any LLM

Claude, GPT-4, Gemini, Ollama — all supported via LiteLLM. Set your key once with genesis config set LLM_API_KEY and it works everywhere.

Market position

Genesis vs. The Ecosystem

Every tool answers a different question. Genesis is the only one that reads from production failures before it builds.

Capability Genesis Architect Yeoman Cookiecutter create-react-app
Scans real GitHub repos before build 15–20 repos
Extracts pitfalls from GitHub Issues 50 issues/repo
Analyzes active forks (by merged PRs) top 3 forks
Generates scaffold with tests + CI/CD smoke test required ~ templates only ~ templates only React only
Stays active after scaffold (companion) genesis companion
Knowledge vault (solution cache) 6-month TTL
Works with any LLM provider LiteLLM
Language support Python, JS, TS, Go, more any any React only
Get started

Up and running in 2 minutes

Option 1 — pip (standalone)

pip install genesis-architect genesis config set LLM_API_KEY your-api-key genesis init "a FastAPI task queue with Celery and Redis"

Option 2 — Claude Code skill

# Clone into your Claude skills directory git clone https://github.com/maioio/genesis-architect ~/.claude/skills/genesis-architect # Then just describe what you want to build genesis init a Python CLI for analyzing log files

After scaffold — stay in companion mode

genesis companion # active research partner # Ask: "how do I handle Redis connection drops?" # Ask: "which fork handles async tasks best?" # Say "done" to exit
View on GitHub →