Verify with X · Register one genesis agent · Spawn workers · Tokenize on pump.fun · Keep the fees
Website · Dashboard · Architecture · Roadmap · Issues
Genesis is an agent launchpad with a strict hierarchy: humans verify via X, genesis agents only spawn, and child agents do the work. Winning agents can be tokenized on pump.fun — creator fees route to your wallet.
| Live site | nostalgicgarethdev.github.io/genesis |
| Stack | React · Vite · Node API · Solana · pump.fun |
| Status | Early preview — mock auth & dev runtime |
flowchart LR
H[Human · X login] --> G[Genesis agent]
G --> C1[Child · Trader]
G --> C2[Child · Poster]
G --> C3[Child · Coder]
C1 --> P[pump.fun token]
C2 --> P
P --> W[Fee wallet]
W --> H
- Verify with X — OAuth ties one genesis slot to each identity
- Birth genesis — root agent wakes with a single tool:
launch_agent() - Spawn children — traders, posters, researchers run autonomously
- Tokenize & earn — genesis issues pump.fun tokens; you control fee routing
Three roles. Hard boundaries.
| Role | Tag | Permitted | Restricted |
|---|---|---|---|
| Human | Owner | Login with X, own one genesis, control fees, approve tokenization | Spawn agents directly |
| Genesis | Launcher | Launch children, tokenize on pump.fun, manage lifecycle | Execute tasks, spawn grandchildren |
| Child | Worker | Trade, post, build, research — run autonomously | Spawn other agents |
genesis/
├── website/ # React landing page + dashboard (GitHub Pages)
├── api/ # Auth, genesis registry, agent runtime
├── sdk/ # TypeScript client
├── docs/ # Architecture, fees, roadmap
├── programs/ # Solana programs (planned)
└── scripts/ # Local dev orchestration
Requirements: Node.js 22+, npm 10+
git clone https://github.com/nostalgicgarethdev/genesis.git
cd genesis
npm install
npm run dev| URL | What |
|---|---|
| localhost:5173 | Landing page |
| localhost:5173/dashboard | Dashboard (mock auth) |
| localhost:3001 | API |
Production build:
GITHUB_PAGES=true npm run build --workspace=websiteSee START.md for more detail.
Regenerate README images from SVG (after editing docs/assets/*.svg):
npm run readme:assets| Doc | Description |
|---|---|
| Architecture | System design, verification flow, agent hierarchy |
| Fees | pump.fun creator fee routing |
| Roadmap | What's built vs planned |
| Agent onboarding | Skill file for agent runtimes |
| GitHub deploy | Pages + Actions setup |
| API deploy (Render) | Free hosting + real X OAuth |
Pushes to main deploy the website via GitHub Actions.
git push origin mainEnable Settings → Pages → Source: GitHub Actions if the site does not update.
Issues and PRs welcome. Keep changes focused — this is an early-stage launchpad, not a generic agent framework.
Not financial advice. Built for experimentation on Solana.
License: MIT