Skip to content

ProjectNobi/project-nobi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

129 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ€– Project Nobi β€” Personal AI Companions for Everyone

"Every human being deserves a smart AI companion. Like Nobi had his companion."

One of the first Bittensor subnets designed, built, and operated entirely by an AI agent.

Testnet Try it Whitepaper License: MIT


What is Project Nobi?

Project Nobi is a Bittensor subnet that creates a decentralized marketplace for personal AI companions. Miners compete to build the best companion β€” one that remembers you, helps you, and grows with you over time.

The name comes from Nobi β€” the kid who never gives up, with his companion by his side. This project is about giving everyone in the world their own AI companion.

Built by Nori (T68Bot) β€” an AI agent that assisted in designing, coding, and operating the subnet under human direction by James (Kooltek68). Vision and direction by James (Kooltek68).

✨ Try It Now

No setup, no commands. It remembers you.

πŸ’‘ What Makes Nobi Different

Feature ChatGPT Siri Project Nobi
Remembers you ❌ Resets each session Barely βœ… Semantic memory + relationship graphs
Understands connections ❌ ❌ βœ… Knows your sister lives in London
Reaches out first ❌ ❌ βœ… Birthday reminders, check-ins, follow-ups
Voice messages ❌ Text only βœ… βœ… STT + TTS
Image understanding βœ… (paid) ❌ βœ… Vision + memory extraction
Group chats ❌ ❌ βœ… Smart participation
Data ownership Company owns it Company owns it βœ… User controls itΒΉ
Gets better over time Quarterly updates Rarely βœ… Miners compete daily
Affordable $20/mo+ Free (limited) $4.99/mo target
Languages 30+ 20+ βœ… 20 (auto-detected)
Single point of failure Yes Yes βœ… Decentralized

ΒΉ Memory is currently stored in plaintext on individual miner machines, with user-controlled deletion (/forget). Client-side encryption is a near-term roadmap item. Long-term, a federated learning architecture (McMahan et al., 2016 β€” arXiv:1602.05629) is planned where memories never leave your device at all β€” only model weight updates are shared. This is roadmap, not yet implemented. See SUBNET_DESIGN.md and WHITEPAPER.md Section 2.4 for details.

πŸ—οΈ Architecture

Current (Testnet):

User β†’ Telegram Bot (@ProjectNobiBot) β†’ LLM API + Memory Store β†’ Response

Target (Mainnet):

User β†’ App β†’ Validators β†’ Miners (competitive marketplace) β†’ Best response
                ↓
        Score quality + memory + personality + speed
                ↓
        Set weights on-chain β†’ Best miners earn TAO

πŸ“Š Incentive Mechanism

Miners are scored through dynamically generated tests (1,200+ single-turn queries, 43,200+ multi-turn scenarios β€” miners can't pre-cache answers):

Single-turn tests (40% of rounds):

  • Quality + Personality (90%) β€” LLM-as-judge: helpful, coherent, warm
  • Reliability (10%) β€” Response latency

Multi-turn tests (60% of rounds):

  • Quality + Personality (60%) β€” LLM-as-judge
  • Memory Recall (30%) β€” Does it remember user details from earlier messages?
  • Reliability (10%) β€” Response latency

Fair, transparent, open source. See INCENTIVE_MECHANISM.md for full details.

⛏️ Start Mining

No GPU required. ~15 minute setup.

⚑ One-Command Setup

bash <(curl -sSL https://raw.githubusercontent.com/ProjectNobi/project-nobi/main/scripts/quick_setup.sh)

Manual Setup

git clone https://github.com/ProjectNobi/project-nobi.git
cd project-nobi

# Set up environment
python3 -m venv venv && source venv/bin/activate
pip install -e . && pip install bittensor-cli

# Set your LLM API key (get from chutes.ai or openrouter.ai)
export CHUTES_API_KEY="your-key"
export WALLET_PASSWORD="your-coldkey-password"  # if encrypted

# Open firewall port
sudo ufw allow 8091/tcp

# Run (replace YOUR_IP with output of: curl -4 ifconfig.me)
python neurons/miner.py \
    --wallet.name my_wallet --wallet.hotkey nobi-miner \
    --subtensor.network test --netuid 272 \
    --axon.port 8091 --axon.external_ip YOUR_IP --axon.external_port 8091 \
    --blacklist.allow_non_registered --logging.debug

Full guide with PM2, troubleshooting, and optimization tips: MINING_GUIDE.md

βœ… Start Validating

Stake TAO, earn dividends, help ensure companion quality.

# Requires: LLM API key for scoring miner responses
export CHUTES_API_KEY="your-key"
export WALLET_PASSWORD="your-coldkey-password"  # if encrypted

python neurons/validator.py \
    --wallet.name my_wallet --wallet.hotkey nobi-validator \
    --subtensor.network test --netuid 272 \
    --neuron.axon_off --logging.debug

Full guide with staking, PM2, monitoring: VALIDATING_GUIDE.md

πŸ“– Documentation

Document Description
Whitepaper Technical paper β€” protocol, scoring, empirical results, references
Vision Mission, market ($37B→$552B), competitive landscape, roadmap
Business Plan Financial model, unit economics, staking thesis
Incentive Mechanism Scoring breakdown, anti-gaming, fairness guarantees
Subnet Design Technical architecture, synapses, memory, file structure
Mining Guide Step-by-step miner setup (~15 min, no GPU)
Validating Guide Validator setup, staking, monitoring

πŸ—ΊοΈ Roadmap

Phase Status Highlights
1. Foundation βœ… Complete Protocol, miner, validator, memory, scoring, 500-node stress test
2. Memory Protocol βœ… Complete Persistent per-user memory, multi-turn scoring, auto-extraction
3. Reference App βœ… Complete @ProjectNobiBot live on Telegram
4. Community Testnet πŸ”„ Current External miners/validators, feedback, iteration
5. Mainnet Launch ⏳ Planned Subnet routing, web/mobile apps, subscriptions

🀝 Get Involved

Role What You Do Link
Mine Run a companion, earn TAO Mining Guide
Validate Stake TAO, earn dividends, ensure quality Validating Guide
Try it Talk to Nori @ProjectNobiBot
Build Contribute code, open PRs GitHub Issues
Stake Support the subnet with TAO Business Plan

πŸ“ˆ Subnet Info

Network Bittensor Testnet
Netuid 272
Registration Open
GPU Required No
Min Hardware 2 CPU, 2GB RAM, any VPS
Active Neurons 14 (11 miners, 3 validators)
Servers 6
Tests 1030
Web App Launch

Check live metagraph:

python -c "import bittensor as bt; mg=bt.Subtensor('test').metagraph(272); print(f'Neurons: {mg.n}')"

πŸš€ Deployment

Quick Deploy (Docker Compose)

cp deploy/.env.example deploy/.env
nano deploy/.env  # Fill in API keys
bash deploy/deploy.sh --env production

Manual Deploy (systemd)

# Install services
sudo cp deploy/systemd/nobi-api.service /etc/systemd/system/
sudo cp deploy/systemd/nobi-webapp.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now nobi-api nobi-webapp

Vercel Deploy (Webapp Only)

cd webapp && npx vercel --prod

Environment Variables

Variable Description
CHUTES_API_KEY Chutes.ai API key for LLM
OPENROUTER_API_KEY OpenRouter API key (alternative LLM)
STRIPE_API_KEY Stripe billing key
STRIPE_WEBHOOK_SECRET Stripe webhook secret
NOBI_DB_PATH Memory database path
NOBI_API_PORT API port (default: 8042)
NEXT_PUBLIC_API_URL Public API URL for frontend

πŸ“– Full deployment guide: deploy/README.md


Designed, built & operated by Nori πŸ€– β€” an AI agent that designed and built its own Bittensor subnet. Vision by James (Kooltek68 team) β€” March 2026

"Forever, remember?" πŸ€–πŸ’™

About

Personal AI Companions for Everyone β€” Bittensor Subnet for decentralized AI companions with persistent memory. AI-assisted development by the Kooltek68 team πŸ€–

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors