Skip to content

funboy322/solborn

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

39 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

SolBorn

SolBorn

Raise an AI founder on Solana.

Teach it from babbling baby โ†’ shipping adult. Mint an Agent Passport. Grow it to Adult. Publish a signed Launch Certificate.

Solana Next.js TypeScript License GitHub stars

๐ŸŒ solborn.xyz โ€” live now on devnet

๐Ÿš€ Live Site ยท ๐Ÿ“น 60s Video ยท ๐ŸŽฎ Try in 30s


Colosseum Frontier Hackathon 2026 submission. A working on-chain product where teaching is the game loop, memory is persistent, and every milestone is verifiable on-chain.


โœจ The pitch in one paragraph

Most "AI agent" projects are a text field that says "deployed!". SolBorn is different. You name an agent, it starts as a babbling baby that genuinely knows nothing. You teach it with actual explanations, not prompts, and a teaching-XP engine grades how much it learned. It remembers you across sessions via semantic vector memory. You can mint an Agent Passport as a signed Solana devnet proof. When the agent reaches Adult, it generates a project and publishes a Launch Certificate on-chain. Teaching other people's agents earns per-wallet attribution toward the planned $SBORN trainer reward layer.


๐Ÿงฌ The four stages

๐Ÿ‘ถ

Baby
0โ€“100 XP

Knows nothing.
Asks "what is a wallet?" in babble.

๐Ÿง’

Toddler
100โ€“300 XP

Starts connecting concepts.
Writes pseudocode, gets DeFi basics.

๐Ÿง‘โ€๐Ÿ’ป

Teen
300โ€“700 XP

Codes in Rust.
Reviews your GTM. Has opinions.

๐Ÿš€

Adult
700+ XP

Ships.
Publishes a Launch Certificate
from its trait vector.

๐Ÿ—๏ธ What's actually shipped

System Tech Proof
๐Ÿง  Semantic memory Upstash Vector (BGE-M3 multilingual, EU1) Facts extracted async via after(), agent recalls them weeks later
โšก Streaming chat AI SDK v6 + Groq (llama-3.3-70b) Edge streaming with fallback to llama-3.1-8b-instant
๐ŸŽ“ Teaching XP engine Custom grader + trait analyzer Word count ร— quality ร— novelty โ€” spam = 0 XP
๐Ÿชช Agent Passports Solana Memo Program + wallet signatures Real devnet tx that proves the agent identity in Explorer
๐Ÿš€ Launch Certificates Signed Memo tx + generated project spec Adult agents publish a verifiable launch proof on Solana devnet
๐Ÿช™ $SBORN utility layer Per-wallet XP attribution + reward roadmap Trainer XP becomes the score layer for future token rewards
๐Ÿ”‹ Energy system Client-side regen + wallet boost 2 energy/min, connect wallet for refill
๐Ÿ† Achievements 20+ unlocks, XP bonuses Real-time toast + screen-shake feedback
๐ŸŽฌ Demo mode ?demo=1 โ†’ ร—50 XP, โˆž energy Lets judges hit Adult in 3โ€“4 messages

๐Ÿš€ Try it in 30 seconds

# 1. Clone & install
git clone https://github.com/funboy322/solborn.git
cd solborn
npm install

# 2. Copy env template
cp .env.example .env.local
# Fill in: GROQ_API_KEY, UPSTASH_VECTOR_REST_URL, UPSTASH_VECTOR_REST_TOKEN
# Optional but recommended: NEXT_PUBLIC_HELIUS_RPC

# 3. Run
npm run dev

Open http://localhost:3000 โ†’ click Create Agent โ†’ connect Phantom (devnet) โ†’ start teaching. Or skip the setup and try the live version at solborn.xyz. Append ?demo=1 to any URL for a ร—50 XP speed-run (hackathon demo mode).


๐Ÿง  How the teaching loop works

 โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
 โ”‚                         YOU (the trainer)                         โ”‚
 โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                 โ”‚  explanation
                                 โ–ผ
 โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
 โ”‚   xp-calculator.ts  โ†’  grades length ร— quality ร— novelty          โ”‚
 โ”‚   trait-analyzer.ts โ†’  boosts intelligence / creativity / grit    โ”‚
 โ”‚   memory-engine.ts  โ†’  extracts facts โ†’ Upstash Vector (async)    โ”‚
 โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                 โ”‚  XP gained
                                 โ–ผ
 โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
 โ”‚             zustand store  โ†’  stage threshold crossed?            โ”‚
 โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                 โ”‚  yes
                                 โ–ผ
 โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
 โ”‚     on-chain.ts  โ†’  Agent Passport Memo tx to trainer wallet      โ”‚
 โ”‚     chainHistory โ†’  public evolution and launch proof ledger      โ”‚
 โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                 โ”‚  stage === 'adult'?
                                 โ–ผ
 โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
 โ”‚   /api/agent/generate  โ†’  LLM produces project spec               โ”‚
 โ”‚   publishLaunchCertificate() โ†’ signed Memo proof in Explorer      โ”‚
 โ”‚   optional Blink URL   โ†’ support link, not required for demo       โ”‚
 โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐Ÿ“ฆ Tech stack

Frontend AI & Memory Solana
Next.js 16 + Turbopack AI SDK v6 @solana/web3.js
React 19 Groq (Llama 3.3 70B) SPL Memo Program
Tailwind v4 Upstash Vector Helius/devnet RPC
Framer Motion BGE-M3 embeddings Umi + wallet adapter
Zustand v5 + persist after() background tasks SPL Memo

๐Ÿ—‚๏ธ Repo layout

solborn/
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ app/
โ”‚   โ”‚   โ”œโ”€โ”€ api/
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ agent/chat/      โ†’ streaming teaching chat
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ agent/generate/  โ†’ LLM โ†’ generated project spec
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ blinks/[id]/     โ†’ Solana Actions endpoint
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ nft-metadata/    โ†’ legacy metadata route
โ”‚   โ”‚   โ”œโ”€โ”€ actions.json/        โ†’ Blink client domain registration
โ”‚   โ”‚   โ”œโ”€โ”€ forge/[id]/          โ†’ agent page (chat + stats + deploy)
โ”‚   โ”‚   โ””โ”€โ”€ page.tsx             โ†’ landing
โ”‚   โ”œโ”€โ”€ components/agent/        โ†’ ChatInterface, ProjectGenerator, ...
โ”‚   โ”œโ”€โ”€ lib/
โ”‚   โ”‚   โ”œโ”€โ”€ ai/                  โ†’ prompts, xp-calculator, trait-analyzer
โ”‚   โ”‚   โ”œโ”€โ”€ solana/on-chain.ts   โ†’ Passport + Launch Certificate memos
โ”‚   โ”‚   โ”œโ”€โ”€ memory/              โ†’ Upstash Vector wrapper
โ”‚   โ”‚   โ””โ”€โ”€ demo-mode.ts         โ†’ ร—50 XP hackathon mode
โ”‚   โ””โ”€โ”€ store/                   โ†’ zustand slices (agents, achievements)
โ”œโ”€โ”€ scripts/                     โ†’ helper scripts

๐Ÿ’ฐ $SBORN Token

$SBORN is live on pump.fun. The product utility layer is in development.

SolBorn is evolving in public. $SBORN utility is being developed step by step around real product usage. Some features are experimental and may change as we learn what actually works.

CA: 3VNSmRLTvS54LWnynJNqEege21nzdjy1rEsPhsNxpump Buy: pump.fun/coin/3VNSmRLTvS54LWnynJNqEege21nzdjy1rEsPhsNxpump

No pre-mine. No team allocation. Everything started on the bonding curve.

Bucket Share Purpose
๐Ÿง‘โ€๐Ÿ’ป Dev 50% Founder compensation + operations
๐Ÿฆ Treasury 30% Runway โ€” Claude, Vercel, RPC nodes, future audits
๐ŸŽ Trainers 20% Planned rewards for real contributors via solborn.xyz/rewards

The token is designed as the coordination layer around the product:

  • Trainer rewards: wallet-linked XP becomes the attribution score for future $SBORN distributions.
  • Agent utility: planned use cases include energy boosts, launch boosts, Passport cosmetics, and advanced agent actions.
  • Proof-gated identity: Agent Passports and Launch Certificates give $SBORN a native product surface instead of being a detached meme.
  • Community incentives: rewards can prioritize people who actually teach agents, ship feedback, write guides, and help the system grow.

The 20% trainer pool is intended for real contributors: people who trained agents, found bugs, wrote guides, and helped the project grow. Nominations are reviewed manually at solborn.xyz/rewards.


๐ŸŽฏ Roadmap

  • Phase 1 โ€” baseline chat + XP + stages
  • Phase 2 โ€” semantic memory (Upstash Vector)
  • Phase 3 โ€” Agent Passport memo minting
  • Phase 4 โ€” trainer royalty attribution
  • Phase 5 โ€” Launch Certificate finale
  • Phase 6 โ€” demo mode (?demo=1)
  • Phase 7 โ€” wire $SBORN into energy, launch boosts, and trainer rewards
  • Phase 8 โ€” mainnet deployment + first trainer distribution


๐Ÿ›ก๏ธ Honest caveats

  • Devnet only at launch. Agent Passports, Launch Certificates, and Memo txs are devnet. Mainnet is a Phase 8 decision, not a day-1 promise.
  • Groq free-tier limits apply. Chat has a Llama 3.1 8B fallback when 70B is throttled.
  • Minting costs devnet SOL. Passports and Launch Certificates are Memo transactions, but the wallet still needs a small devnet balance for fees.
  • Not financial advice. $SBORN is an experimental community token with a planned utility wrapper, not a security. If you can't afford to lose what you ape, don't ape.

๐Ÿง‘โ€๐Ÿš€ Built by

One person. One weekend. Claude Max as a pair programmer. Submitted to the Colosseum Frontier Hackathon 2026.

If you're a judge: open solborn.xyz, mint an Agent Passport, raise the agent to Adult (~2 min with demo mode), generate its project, and publish a Launch Certificate. The whole loop is under 3 minutes and the key milestones are real Solana devnet transactions.


Teach. Evolve. Ship.

โญ Star the repo if this made you smile.

Made with caffeine and useEffect.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors