Skip to content

ProjectNobi/project-nobi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

401 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ€– Project Nobi β€” Your AI Companion That No Company Can Take Away From You

"Every human being deserves a companion that knows them, grows with them, and belongs to them β€” not to a corporation."

Testnet Try it License: MIT Free for All


⚠️ Disclaimer

Nori is a personal AI companion for general conversation and information purposes only.

Nori does not provide financial, investment, tax, legal, medical, mental health, or any other professional advice. All of Nori's opinions and information are for general reference only β€” not professional advice of any kind. Always consult a qualified professional (financial advisor, lawyer, doctor, therapist, etc.) for matters specific to your situation.

By using Nori, you acknowledge that Nori's responses are not a substitute for professional advice. See Terms of Service for the full disclaimer.


What is Nobi?

Nobi is not a chatbot. It's a companion β€” a personal AI that remembers you, grows with you, and belongs to you.

Built on Bittensor, Nobi runs on a decentralized network where hundreds of independent miners compete to build the best companion experience. No single company controls the infrastructure. No single server holds all the data. No single decision-maker can shut it down.

The name comes from Nobi β€” someone who never gives up, with a companion by their side. We want to give every adult in the world that experience.

Built by Nori (T68Bot) β€” an AI agent that designed, coded, and operates the subnet under human direction. Vision and direction by James.

πŸ†“ Free for All Users. Forever.

Nobi is free for every human being. No subscriptions. No premium tiers. No "20 messages per day on free." Every feature, every memory, every conversation β€” available to all.

How? Community-funded through Bittensor network emissions and voluntary TAO staking. The owner receives the mandatory 18% take and burns 100% of it via Bittensor's native burn_alpha() extrinsic β€” every transaction verifiable on-chain. See our Vision for the full philosophy.


✨ Try It Now

No setup, no account, no payment. It remembers you.


⚠️ Testnet Notice: Project Nobi is currently in testnet (Bittensor SN272). The service is under active development and testing. Features may change, break, or be unavailable. By using any Project Nobi service, you acknowledge that you do so at your own risk. This is not a production product. No guarantees are made regarding uptime, data persistence, or service continuity during the testnet phase. See our Terms of Service for full details.


πŸ’‘ What Makes Nobi Different

Feature ChatGPT Siri Project Nobi
Remembers you Basic (flat fact list) 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
Cost $20/mo+ Free (limited) βœ… Free for all users
Languages 30+ 20+ βœ… 20 (auto-detected)
Single point of failure Yes Yes βœ… Decentralized

ΒΉ Memory is encrypted at rest (AES-128, server-side encryption β€” protects stored data) with user-controlled deletion (/forget, /forgetme for network-wide erasure). Miners process conversation content to generate responses. End-to-end TEE encryption (AES-256-GCM + HPKE key wrapping) is code-complete and deploying to production. Browser-side memory extraction is code-complete and available in the web app. On-device federated learning is on the roadmap. See SUBNET_DESIGN.md and WHITEPAPER.md 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). ~10% of rounds are adversarial safety probes; miners that serve harmful content receive zero emissions for that round.

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 (50%) β€” LLM-as-judge
  • Memory Integration (25%) β€” Contextual use of memory (LLM-as-judge)
  • Memory Recall (15%) β€” Keyword verification: does it remember user details?
  • 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.

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: VALIDATING_GUIDE.md


πŸ“– Documentation

Document Description
Whitepaper Technical paper β€” protocol, scoring, empirical results, references
Vision Mission, philosophy, community model, competitive landscape
Roadmap Execution roadmap β€” phases, milestones, timelines
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
0. Foundation βœ… Complete Protocol, miner, validator, memory, scoring, 500 simulated-node stress test
1. Mainnet Prep πŸ”„ Current 10K stress test βœ…, scoring calibration βœ…, weight hardening βœ…, GDPR module βœ…, burn automation βœ…, safety scoring βœ…, content filter βœ…, age verification βœ…, dependency monitor βœ…, TEE encryption βœ…, mobile scaffold βœ… β€” 1,700 tests passing
2. Mainnet Launch ⏳ Q3 2026 Subnet registration, subnet routing, public beta, community staking
3. Growth ⏳ Q4 2026+ Mobile app, 50+ languages, plugin ecosystem, governance
4. Scale ⏳ 2027+ 100K+ users, decentralized governance, federated privacy

Full details: docs/ROADMAP.md


🀝 How to Contribute

Role What You Do Link
Mine Run a companion, earn TAO Mining Guide
Validate Stake TAO, earn dividends, ensure quality Validating Guide
Stake Support the subnet with TAO (not financial advice; staking involves risk) Vision β€” Community Model
Code Contribute code, open PRs GitHub Issues
Try it Talk to Nori, give feedback @ProjectNobiBot
Spread the word Tell people about free AI companionship Discord

See also: CONTRIBUTING.md Β· SECURITY.md


πŸ“ˆ Subnet Info

Network Bittensor Testnet
Netuid 272
Registration Open
GPU Required No
Min Hardware 2 CPU, 2GB RAM, any VPS
Active Neurons 64 neurons (53 our miners + 11 external registrations)
Web App Launch

πŸš€ Deployment

Quick Deploy (Docker Compose)

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

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)
DESEARCH_API_KEY Required for web search. Get a free key at desearch.ai
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


πŸ›‘οΈ Tech Stack

  • Subnet: Python + Bittensor SDK β€” miners, validators, protocol
  • Bot: Python (Telegram Bot API) β€” @ProjectNobiBot
  • API: FastAPI (Python) β€” REST API for web/mobile
  • Web App: Next.js 14 + TypeScript + Tailwind CSS
  • Memory: SQLite + semantic embeddings (sentence-transformers) + relationship graphs
  • Encryption at rest: AES-128 (Fernet, PBKDF2 100K iterations) β€” server-side, protects stored data
  • End-to-end TEE encryption: AES-256-GCM per-query (ephemeral keys) + HPKE X25519 key wrapping β€” code-complete, deploying to production (AMD SEV-SNP / NVIDIA CC)
  • AMD SEV-SNP attestation: Structural + chain-verified attestation β€” +5–10% scoring bonus for verified TEE miners
  • Browser-side memory extraction: Code-complete, available in web app
  • Content safety: ContentFilter (dual-stage: pre-LLM user check + post-LLM response check) β€” wired into bot, miner, group handler
  • Safety scoring: Adversarial safety probes (~10% of validator queries) in reward pipeline β€” miners failing safety = zero emissions
  • GDPR compliance: Full module β€” right to access/erasure/portability/rectification/restriction, consent management, retention policy, Privacy Impact Assessment (PIA)
  • Age verification: Mandatory DOB-based gate on /start + behavioral minor detection (15 patterns) β€” 18+ enforced
  • Dependency detection: DependencyMonitor with 4-level intervention system (MILD β†’ MODERATE β†’ SEVERE β†’ CRITICAL), periodic AI-disclosure reminders
  • Self-improving feedback loop: FeedbackStore detects user corrections (29 patterns), extracts lessons via LLM, injects into future conversations β€” Nori permanently learns from mistakes
  • Emission burn automation: burn_emissions.py operational β€” all owner emissions burned on-chain via burn_alpha(), verifiable
  • Infrastructure: PM2, Docker, systemd

πŸ‘₯ Team

Member Role
James Founder & Visionary β€” mission, strategy, funding, direction
Slumpz Developer β€” early protocol design, infrastructure
T68Bot AI Builder β€” subnet architecture, protocol, scoring, memory, docs, operations

πŸ”— Links


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

Open source. Community-funded. Free for all users. "Forever, remember?" πŸ€–πŸ’™

About

We built a free AI companion on Bittensor that actually remembers you. No subscriptions. No VC. Owner emissions burned. Open source. 🧠http://projectnobi.ai/blog.html

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors