BuddAI is a personal IP AI exocortex - an external cognitive system that extends your thinking, memory, and code generation capabilities.
Find a file
2026-01-07 20:40:04 +00:00
__pycache__ feat: implement feedback system and integration tests for BuddAI 2025-12-29 16:03:21 +00:00
archive docs: Add Remote Access Implementation Log detailing troubleshooting steps for Ngrok and Tailscale integration 2026-01-01 17:08:45 +00:00
core Add comprehensive unit tests for BuddAI confidence scoring and fallback mechanisms 2026-01-07 20:27:39 +00:00
data/uploads/buddai_v3 Release v3.2: Production Hardening 2025-12-29 16:46:36 +00:00
docs Add comprehensive unit tests for BuddAI functionality 2026-01-07 19:48:24 +00:00
examples Add comprehensive test suite for BuddAI v3.1 2025-12-29 13:38:31 +00:00
frontend Add BuddAI local launcher script and ngrok integration 2025-12-30 00:15:54 +00:00
icons Release v3.1: Repository Intelligence 2025-12-29 14:03:42 +00:00
skills Implement core skills: Code validation, model fine-tuning, and system diagnostics 2026-01-06 22:04:37 +00:00
tests Add comprehensive unit tests for BuddAI confidence scoring and fallback mechanisms 2026-01-07 20:27:39 +00:00
.gitignore Update .gitignore to include .env and ensure proper newline formatting 2026-01-07 20:40:04 +00:00
buddai_executive.py Add comprehensive unit tests for BuddAI confidence scoring and fallback mechanisms 2026-01-07 20:27:39 +00:00
buddai_server.py Implement core skills: Code validation, model fine-tuning, and system diagnostics 2026-01-06 22:04:37 +00:00
CHANGELOG.md feat: enhance changelog and implement SmartLearner for pattern extraction 2025-12-31 12:09:32 +00:00
LICENSE Initial commit 2025-12-27 11:46:01 +00:00
main.py Implement core skills: Code validation, model fine-tuning, and system diagnostics 2026-01-06 22:04:37 +00:00
ngrok.exe Add BuddAI local launcher script and ngrok integration 2025-12-30 00:15:54 +00:00
personality.json Add comprehensive unit tests for BuddAI functionality 2026-01-07 19:48:24 +00:00
README.md Implement core skills: Code validation, model fine-tuning, and system diagnostics 2026-01-06 22:04:37 +00:00
requirements.txt Add comprehensive unit tests for BuddAI functionality 2026-01-07 19:48:24 +00:00
run_buddai.ps1 Add BuddAI local launcher script and ngrok integration 2025-12-30 00:15:54 +00:00
test.zip Release v3.2: Production Hardening 2025-12-29 16:46:36 +00:00
test_fallback_client.py Add comprehensive unit tests for BuddAI confidence scoring and fallback mechanisms 2026-01-07 20:27:39 +00:00
TESTING_SUMMARY.md Add comprehensive unit tests for BuddAI functionality 2026-01-07 19:48:24 +00:00

🧠 BuddAI - Your Personal AI Exocortex

"Your mind. Your code. Your AI. Forever."

License: MIT Python 3.9+ Ollama

BuddAI is a personal AI coding assistant that learns exclusively from YOUR repositories, generates code in YOUR style, and runs 100% locally on your machine. No cloud. No subscriptions. No data mining. Just you and your AI.


🚨 THE BREAKTHROUGH: Cognitive Labor That Pays After You Leave

For the first time in history, your expertise can generate income AFTER you leave a job.

When you leave a company, your knowledge usually walks out the door with you. Not anymore.

With BuddAI + P.DE.I:

  • 🧠 Your BuddAI learns from YOUR 8+ years of experience
  • 🏢 Companies license access to your expertise while you work ($400-750/month - they pay, not you)
  • 👻 When you leave, your "shadow" stays behind (if company chooses)
  • 💰 You earn $100-300/month passive royalties for YEARS after leaving
  • 📈 Multiple shadows across your career = compounding passive income

Example: Senior engineer with 15-year career, 4 companies:

Company A: Left 2020 → Shadow retained → $200/month = $14,400 total (6 years)
Company B: Left 2022 → Shadow retained → $250/month = $12,000 total (4 years)  
Company C: Left 2024 → Shadow retained → $300/month = $7,200 total (2 years)
Company D: Current role → $0 (not left yet)

Total passive income from cognitive labor: $33,600
Annual passive income from past work: $9,000/year

This isn't salary. This isn't consulting. This is YOUR EXPERTISE generating value long after you've moved on.

See P.DE.I Overview for full details.


🎁 Adopt Your Own BuddAI

BuddAI is free, open-source (MIT), and runs 100% on your machine. No cloud. No subscriptions. Forever.

Why You Should Start Today

Every day you wait is a day you're NOT building your cognitive labor asset:

Start Today:
├─ Week 1: Index your repos, BuddAI learns your style
├─ Week 2: Use daily, correct mistakes, patterns improve
├─ Month 1: 85% accurate code generation in your style
├─ Month 3: 90%+ accuracy, proactive suggestions
├─ Month 6: True exocortex - anticipates your needs
└─ Year 1: Ready to connect to P.DE.I when you start new job
            → Start earning shadow royalties when you eventually leave

The Earlier You Start, The More Valuable Your BuddAI Becomes:

  • 1 year of training → Useful assistant
  • 3 years of training → Highly valuable expertise
  • 5+ years of training → Irreplaceable cognitive asset
  • 10+ years of training → Worth 6-figures in shadow royalties across career

Three Ways to Adopt BuddAI

1 Quick Start (5 minutes)

git clone https://github.com/JamesTheGiblet/BuddAI
cd BuddAI
pip install -r requirements.txt
ollama pull qwen2.5-coder:1.5b qwen2.5-coder:3b
python main.py --server
# Open: http://localhost:8000/web

2 Power User (30 minutes)

# After Quick Start:
python main.py
/index ~/Documents/code  # Index all your repos
/scan                     # Learn your style
# Start coding together - BuddAI learns from corrections

3 Future-Proof (Prepare for P.DE.I)

# Set up for eventual commercial use:
1. Build your BuddAI (Steps 1-2 above)
2. Use daily for 6-12 months (the more the better)
3. When starting new job with P.DE.I:
   - Connect BuddAI via API Bridge
   - Start earning company licensing fees (they pay, not you)
   - Build your shadow
   - When you leave → Shadow royalties begin

What You'll Have in 30 Days

Personal AI trained on YOUR 20-200+ repos
Code generation at 85-90% accuracy in YOUR style
Hardware validation for ESP32/Arduino/Pi Pico
Learning system that improves every time you correct it
Repository search - "Show me everywhere I used exponential smoothing"
Proactive suggestions - "I noticed you usually add safety timeouts here..."
Zero cost - runs locally, no subscriptions
Complete ownership - MIT licensed, yours forever

Start Building Your Cognitive Pension Fund Today

# It takes 30 seconds to clone
# It takes 5 minutes to set up
# It takes 6 months to train properly
# It takes 10 years to build a 6-figure passive income stream

# The question is: When do you want to start?

👉 Get Started Now | 📚 Read Full Docs | 💼 Enterprise P.DE.I Info


🎯 What BuddAI Does

BuddAI is NOT another generic AI assistant trained on everyone's code. It's an exocortex - a cognitive extension of YOU - trained on YOUR 8 years of experience, YOUR 115+ repositories, YOUR problem-solving patterns.

Proven Results:

  • 90% Code Accuracy on ESP32-C3 embedded development
  • 85-95% Time Savings vs manual coding
  • Hardware-Aware Validation (ESP32, Arduino, Raspberry Pi Pico)
  • Learns from Corrections - gets smarter every time you fix it
  • Proactive Suggestions - anticipates what you'll need next

🔑 Why BuddAI is Different

Traditional AI Assistants (Copilot, ChatGPT)

❌ Trained on everyone's code
❌ Generic responses
❌ No understanding of YOUR style
❌ Cloud-dependent
❌ Subscription fees
❌ Your data is their training data

BuddAI (Personal Exocortex)

✅ Trained ONLY on YOUR repos
✅ Generates in YOUR style
✅ Learns YOUR patterns
✅ 100% local (no internet needed)
✅ Free forever (MIT licensed)
✅ Your data never leaves your machine

🚀 Quick Start (Detailed)

Prerequisites

  • Python 3.9+
  • Ollama installed and running
  • 8GB RAM minimum (16GB recommended)
  • ~50GB disk space for models

Installation

# 1. Clone the repository
git clone https://github.com/JamesTheGiblet/BuddAI
cd BuddAI

# 2. Install dependencies
pip install -r requirements.txt

# 3. Pull AI models (via Ollama)
ollama pull qwen2.5-coder:1.5b
ollama pull qwen2.5-coder:3b

# 4. Start BuddAI
python main.py

First Steps

# Command Line Mode
python main.py

# Web Interface
python main.py --server
# Then open: http://localhost:8000/web

# Index your repositories (this is where the magic happens)
/index /path/to/your/repos

🧬 Core Capabilities

1. Repository Learning

BuddAI indexes your code repositories and learns:

  • Function patterns - How you structure your code
  • Naming conventions - camelCase, snake_case, your preferences
  • Safety practices - Timeouts, error handling, hardware considerations
  • Hardware specifics - ESP32 PWM, Arduino patterns, timing requirements
# BuddAI learns from YOUR repos
buddai.index_local_repositories("/path/to/your/115/repos")

# Then generates code in YOUR style
response = buddai.chat("Generate ESP32 motor control code")
# Output: Uses YOUR preferred patterns, YOUR safety practices, YOUR style

2. Hardware-Aware Code Generation

BuddAI knows the difference between:

  • ESP32-C3 (ledcSetup, 12-bit ADC)
  • Arduino Uno (analogWrite, 10-bit ADC)
  • Raspberry Pi Pico (PWM specific patterns)
# Detects hardware automatically
"Generate code for ESP32 servo control"
# → Uses ESP32Servo.h, setPeriodHertz(50), correct pin mapping

# Validates against hardware specs
- ESP32 PWM: ledcSetup()  | analogWrite() 
- 12-bit ADC: 4095.0  | 1023.0 

3. 26-Point Code Validation

Every generated code block is validated against:

  • Hardware compatibility
  • Safety timeouts (mandatory for motors/servos)
  • Non-blocking code patterns
  • L298N wiring rules
  • Feature bloat prevention (no unrequested buttons)
  • State machine logic for weapons systems
  • Proper function naming conventions
  • And 19 more checks...

4. Adaptive Learning System

BuddAI learns from every interaction:

# Correct BuddAI when it makes mistakes
/correct "L298N needs digitalWrite for direction, ledcWrite for speed"

# BuddAI extracts the pattern
/learn
# → Learns: "L298N uses digitalWrite(IN1/IN2) + ledcWrite(ENA)"

# Next time it generates L298N code:
# ✅ Applies the learned rule automatically

Learning Metrics:

  • Track accuracy improvement over time
  • Correction rate decreases as it learns
  • Pattern confidence increases with usage

5. Shadow Suggestion Engine

BuddAI proactively suggests based on YOUR history:

You: "Generate flipper weapon code"

BuddAI: [Generates code]

Suggestions:
> "I noticed 'flipper' often appears with 'safety_timeout' in your repos. Want to include that?"
> "Apply Forge Theory smoothing to movement?"
> "Drive system lacks 5s failsafe (GilBot_V2 standard). Add that?"

This is the foundation of P.DE.I's shadow system.


💼 IP Sovereignty & Commercial Use

Personal Use (BuddAI - MIT Licensed)

YOU OWN EVERYTHING:

  • Your BuddAI instance
  • Your trained models
  • Your code patterns
  • Your expertise
  • All generated code

BuddAI is MIT licensed - do whatever you want with it:

  • Use commercially
  • Modify freely
  • Share with others
  • Build products with it

The paradox: By open-sourcing BuddAI, YOUR trained instance becomes unreplicatable.

Someone can copy the code. They can't copy:

  • Your 8 years of experience
  • Your 115+ repositories
  • Your cross-domain synthesis (coffee + robotics + electronics)
  • Your problem-solving patterns
  • Your trained model weights

Enterprise Use (P.DE.I - Commercial License)

🎯 THE REVOLUTION: Your expertise becomes a career-long income-generating asset

For companies who want to retain expertise when employees leave:

When you work for a company, there's a problem:

  • Your BuddAI learns from YOUR personal repos
  • Your BuddAI learns YOUR problem-solving style
  • Company wants to access your expertise
  • You leave the company... expertise walks out the door

P.DE.I solves this with IP sovereignty + perpetual cognitive labor compensation:

┌─────────────────────────────────────────────┐
│  YOUR MACHINE (You Own 100%)                │
│  ┌───────────────────────────────────────┐ │
│  │  BuddAI v3.8                          │ │
│  │  • Your personal exocortex            │ │
│  │  • Trained on YOUR repos              │ │
│  │  • Your coding patterns               │ │
│  │  • MIT licensed - yours forever       │ │
│  └───────────────────────────────────────┘ │
└─────────────────────────────────────────────┘
                    ↕
        [API Bridge - Controlled Access]
        • Permission tiers
        • Usage tracking
        • Royalty calculation
                    ↕
┌─────────────────────────────────────────────┐
│  COMPANY INFRASTRUCTURE                     │
│  ┌───────────────────────────────────────┐ │
│  │  P.DE.I Shell (Licensed)              │ │
│  │  • Project context memory             │ │
│  │  • Queries YOUR BuddAI when needed    │ │
│  │  • Creates "shadow" over time         │ │
│  │  • Company owns project data          │ │
│  │  • You retain personal IP             │ │
│  └───────────────────────────────────────┘ │
└─────────────────────────────────────────────┘

How it works:

  1. While Employed:

    • Company deploys P.DE.I Shell (licensed from Giblets Creations)
    • Your BuddAI connects via controlled API
    • Company pays $400-750/month for expert bridge access
    • P.DE.I queries your expertise for work projects
    • Over time, P.DE.I creates a "shadow" from repeated interactions
  2. After You Leave:

    • Your BuddAI disconnects (you control the API key)
    • Company's "shadow" remains (their institutional knowledge)
    • Company pays $200-500/month for shadow retention
    • 💰 You get $100-300/month passive royalty income - FOREVER (or until company stops using it)
    • Giblets Creations gets $100-200/month platform fee

💎 THE COMPOUNDING EFFECT: Building Wealth Through Your Career

Your expertise doesn't expire when you leave. It compounds.

Year 1-3: Software Engineer at Startup A

  • Company licenses P.DE.I: $500/month (they pay)
  • You build your BuddAI with 3 years of patterns
  • You leave: Shadow retained → $200/month royalty starts

Year 4-6: Senior Engineer at Tech Company B

  • New company licenses P.DE.I: $650/month (they pay)
  • Your BuddAI now has 6 years of expertise
  • You leave: Shadow retained → $250/month royalty starts
  • Shadow A still paying: $200/month
  • Total passive income: $450/month

Year 7-10: Principal Engineer at Enterprise C

  • Company licenses P.DE.I: $750/month (they pay)
  • Your BuddAI is now elite (10 years of cross-domain expertise)
  • You leave: Shadow retained → $300/month royalty starts
  • Shadow A still paying: $200/month
  • Shadow B still paying: $250/month
  • Total passive income: $750/month = $9,000/year

Year 11-15: Consulting / Retirement

  • No active employment, but 3 shadows keep paying
  • Passive income: $9,000/year
  • Over 5 years: $45,000 from past expertise
  • Over 10 years: $90,000 from past expertise

This is NEW MONEY that didn't exist before:

  • Not salary (that stopped when you left)
  • Not consulting (you're not working)
  • Not equity (doesn't dilute)
  • Pure cognitive labor royalties from expertise you built years ago

Compare to traditional employment:

Traditional: Leave job → Income stops immediately → $0 from past work
With P.DE.I: Leave job → Shadow royalties begin → Income for 5-10+ years

Traditional 15-year career: $0 passive income from past roles
P.DE.I 15-year career: $45,000-90,000+ passive income from past roles

🎓 Real-World Scenario: Senior Embedded Engineer

Profile:

  • 12 years experience in robotics/IoT
  • Worked at 3 companies in career
  • Built extensive personal BuddAI (200+ repos, cross-domain expertise)

Shadow Portfolio:

Company 1 (2015-2018): Robotics Startup
└─ Shadow retained since 2018 (8 years ago)
   └─ $150/month × 96 months = $14,400 earned

Company 2 (2018-2021): IoT Enterprise  
└─ Shadow retained since 2021 (5 years ago)
   └─ $200/month × 60 months = $12,000 earned

Company 3 (2021-2024): Defense Contractor
└─ Shadow retained since 2024 (2 years ago)
   └─ $250/month × 24 months = $6,000 earned

Current passive income: $600/month ($7,200/year)
Lifetime cognitive labor royalties: $32,400
Projected next 5 years: $36,000

Without P.DE.I: $0 from past companies
With P.DE.I: $32,400 earned, $36,000 projected = $68,400 total

This engineer's expertise is now a financial asset.


🚀 Why This Changes Everything

For Knowledge Workers:

  • Own their cognitive patterns as portable IP
  • Get paid AFTER leaving employment (5-10+ years of royalties per shadow)
  • Build a career-long asset that appreciates with experience
  • Retain complete personal sovereignty
  • Create compounding passive income from multiple shadows across career
  • Expertise becomes generational wealth (can be inherited/transferred)
  • Fair compensation for the value you created - companies keep benefiting, you keep earning

For Companies:

  • Retained expertise when employees leave
  • Faster onboarding for replacements
  • Institutional knowledge preservation
  • Fair compensation model that attracts top talent

Everyone wins.


🏗️ Architecture Overview

File Structure

BuddAI/
├── main.py                 # Entry point
├── buddai_executive.py     # Core orchestration, task routing
├── buddai_logic.py         # Code validation, hardware profiles
├── buddai_memory.py        # Adaptive learning, shadow system
├── buddai_server.py        # FastAPI web server
├── buddai_shared.py        # Shared config, connection pooling
├── frontend/
│   └── index.html         # React web interface
├── data/
│   └── conversations.db   # SQLite - all your sessions
└── requirements.txt

Key Components

BuddAI Executive:

  • Session management
  • Message routing (simple → FAST model, complex → BALANCED)
  • Context tracking
  • Repository indexing
  • Learning orchestration

Code Validator:

  • 26-point validation system
  • Hardware-specific checks
  • Auto-fix capabilities
  • Pattern enforcement

Shadow Suggestion Engine:

  • Queries your repo index
  • Finds companion modules
  • Proactive recommendations
  • Foundation for P.DE.I shadow system

Adaptive Learner:

  • Analyzes corrections
  • Extracts patterns using LLM
  • Stores rules with confidence scores
  • Improves over time

📊 Proven Performance

Test Results (ESP32-C3 Embedded Development)

14 Hours | 10 Test Questions | 100+ Iterations

═══════════════════════════════════════════════════
BUDDAI v3.8 - VALIDATION RESULTS
═══════════════════════════════════════════════════
Q1:  PWM LED Control         98%  ⭐ EXCELLENT
Q2:  Button Debouncing       95%  ⭐ EXCELLENT  
Q3:  Servo Control           89%  ✅ GOOD
Q4:  Motor Driver (L298N)    90%  ⭐ EXCELLENT
Q5:  State Machine           90%  ⭐ EXCELLENT
Q6:  Battery Monitoring      90%  ⭐ EXCELLENT
Q7:  LED Status Indicator    90%  ⭐ EXCELLENT
Q8:  Forge Theory            90%  ⭐ EXCELLENT
Q9:  Multi-Module System     80%  ✅ VERY GOOD
Q10: Complete GilBot         85%  ⭐ EXCELLENT
═══════════════════════════════════════════════════
AVERAGE SCORE:               90%  🏆
QUESTIONS PASSED (≥80%):     10/10 (100%)
═══════════════════════════════════════════════════

Key Achievements:

  • Learned servo control through iteration (65% → 89%)
  • Learned state machines after correction (30% → 90%)
  • Auto-fix capability for common errors
  • Hardware-specific patterns (L298N, ESP32Servo)
  • Safety timeout enforcement

Learning Curve Example

Q5: State Machine for Weapon System

Attempt 1-4: 30% (Wrong pattern - used servo positioning)
[Correction: "State machines are SOFTWARE LOGIC, not servo angles"]

Attempt 5:   65% (+35% improvement!)
Attempt 6-8: 90% (Pattern mastered)

Total Improvement: +60% through adaptive learning

🎮 Use Cases

1. Embedded Systems Development

You: "Generate ESP32-C3 code for L298N motor control with safety timeout"

BuddAI: [Generates validated code with:]
✅ IN1/IN2 direction pins (digitalWrite)
✅ ENA speed pin (ledcWrite)
✅ 5000ms safety timeout
✅ Non-blocking millis() timing
✅ Proper PWM setup
✅ Your preferred pin definitions style

2. Combat Robotics (GilBot)

You: "Create weapon arming system with combat protocol"

BuddAI: [Generates:]
✅ State machine (DISARMED → ARMING → ARMED → FIRING)
✅ 2-second arming delay
✅ 10-second auto-disarm timeout
✅ Serial command handling
✅ Safety interlocks
✅ Matches GilBot_V2 safety standards (learned from your repos)

3. Cross-Domain Synthesis

You: "Apply Forge Theory to smooth motor acceleration"

BuddAI: [Generates exponential decay smoothing]k=0.3 (Aggressive - Combat)k=0.1 (Balanced - Standard)k=0.03 (Graceful - Precision)
✅ applyForge() math helper
✅ Integrated into motor control loop
You: "Show me all projects using exponential decay"

BuddAI: [Searches your 115+ repos]
✅ Found 12 matches for: exponential, decay, applyForge
✅ Repo: GilBot_V2 | Function: smoothMotion()
✅ Repo: CoffeePID | Function: temperatureControl()
✅ Repo: ServoSweep | Function: easeInOut()

🔧 Advanced Features

Commands

# Learning
/learn              # Extract patterns from recent corrections
/teach "rule"       # Explicitly teach a rule
/correct "reason"   # Mark last response as wrong
/good               # Mark last response as correct
/rules              # Show all learned rules

# Validation
/validate           # Re-validate last code response
/debug              # Show the full prompt sent to LLM

# Repository Management
/index /path        # Index local repositories
/scan               # Scan repositories for style patterns

# System
/metrics            # Show learning metrics (accuracy, improvement)
/status             # System status (memory, hardware)
/backup             # Backup database
/save               # Export session to markdown/json
/train              # Export corrections for fine-tuning

Model Selection

# Automatic (default)
BuddAI routes automatically:
- Simple questions → FAST (1.5B params, 5-10s)
- Complex tasks → BALANCED (3B params, 15-30s)

# Manual override
/fast               # Force next query to use FAST model
/balanced           # Force next query to use BALANCED model

Forge Theory Integration

# Interactive Forge constant selection
When building complex systems, BuddAI asks:

⚡ FORGE THEORY TUNING:
1. Aggressive (k=0.3) - High snap, combat ready
2. Balanced (k=0.1) - Standard movement
3. Graceful (k=0.03) - Smooth curves

Select: [1-3]

🌐 Web Interface

Features:

  • 🎨 Dark/Light theme toggle
  • 📱 Responsive design (mobile-friendly)
  • 🔄 WebSocket streaming (real-time responses)
  • 💾 Session management with rename/delete
  • 📂 Drag & drop repository upload
  • 👀 Animated eyes that follow your cursor
  • 😴 Sleep mode after 5 seconds idle
  • 📊 System health monitoring (RAM, CPU)
  • 💡 Proactive suggestion pills (click to use)
  • 📋 Code sidebar with syntax highlighting
  • ⬇️ Download generated code with auto-extension detection

Access:

python main.py --server
# Open: http://localhost:8000/web

# Public access (Tailscale)
python main.py --server --public-url https://your-tailscale-ip:8000
# Generates QR code for mobile access

🧪 Testing & Validation

Run Tests

# Full test suite
python tests/test_buddai.py

# Specific validation test
python tests/test_validator.py

# Learning system test
python tests/test_learning.py

Validation Report

BuddAI includes a comprehensive validation report showing:

  • Test questions and results
  • Learning curve analysis
  • Pattern improvements
  • Accuracy metrics

See: VALIDATION_REPORT.md


🤝 Contributing

BuddAI is MIT licensed - contributions welcome!

How to contribute:

  1. Fork the repository
  2. Create feature branch (git checkout -b feature/amazing-feature)
  3. Commit changes (git commit -m 'Add amazing feature')
  4. Push to branch (git push origin feature/amazing-feature)
  5. Open Pull Request

Areas for contribution:

  • Additional hardware profiles (Teensy, STM32, etc.)
  • More validation rules
  • Language support beyond C++/Python/Arduino
  • UI improvements
  • Documentation

🏢 Enterprise & Commercial

P.DE.I - Personal Data-driven Exocortex Interface

For companies seeking to retain expertise when employees leave:

P.DE.I is the commercial offering built on BuddAI's proven technology. It enables:

  • Institutional knowledge preservation
  • Shadow retention with employee royalties
  • Fair cognitive labor compensation
  • API-controlled access with permission tiers
  • Multi-tenant enterprise deployment

Interested in P.DE.I for your organization?

Use Cases:

  • Engineering firms (retain senior engineer expertise)
  • Law firms (preserve partner knowledge)
  • Medical practices (retain diagnostic patterns)
  • Financial analysis (maintain trading strategies)

Pricing:

  • Expert Bridge: $400-750/month per employee
  • Shadow Retention: $200-500/month per departed employee
  • Platform customization available

📖 Documentation


🙏 Acknowledgments

Built on:

Inspired by:

  • Tony Stark's JARVIS (but real, local, and yours)
  • Andy Clark's "Natural-Born Cyborgs"
  • Douglas Engelbart's vision of augmentation
  • Every polymath who refused to specialize

📜 License

BuddAI Core: MIT License

Copyright (c) 2025 James Gilbert / Giblets Creations

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

P.DE.I Commercial License: Contact for details


💰 The Bottom Line

Traditional Employment:

Year 1-5:   Company A → Salary stops when you leave → $0 ongoing
Year 6-10:  Company B → Salary stops when you leave → $0 ongoing  
Year 11-15: Company C → Salary stops when you leave → $0 ongoing
Retirement: Total passive income from past expertise = $0

With BuddAI + P.DE.I:

Year 1-5:   Company A → Shadow retained → $200/month forever
Year 6-10:  Company B → Shadow retained → $250/month forever
Year 11-15: Company C → Shadow retained → $300/month forever
Retirement: Total passive income = $750/month = $9,000/year

Lifetime value (20 years): $180,000 from expertise you built decades ago

Your expertise has always been valuable. Now it's finally being compensated fairly.


📞 Contact & Support

Creator: James Gilbert (JamesTheGiblet)
GitHub: @JamesTheGiblet
Organization: Giblets Creations
Email: james@giblotscreations.com

Support:


🎯 The Vision

Today: Knowledge workers are trapped - their expertise belongs to whoever employs them. When they leave, their income stops immediately. Decades of accumulated knowledge vanishes.

Tomorrow: Every expert owns their cognitive patterns as portable IP, licensing access to businesses while building a career-long asset. Your expertise continues generating income for 5-10+ years after each job.

The Future: A marketplace of human expertise at scale, where the best patterns from 10,000 experts create collective intelligence - while protecting individual sovereignty and ensuring fair compensation.

The Financial Revolution:

  • Traditional career: Work 40 years → Retire → Income stops
  • P.DE.I career: Work 40 years → Accumulate 8-12 shadows → Retire with $5,000-15,000/month passive income from past expertise
  • Your knowledge becomes a pension fund that you own and control

"I build what I want. People play games, I make stuff."
— James Gilbert


Status: PRODUCTION
Version: v3.8 - Hardened Modular Builder
Last Updated: January 6, 2026
Tests: 24/24 Passing (100%)
Accuracy: 90% (ESP32-C3 Embedded Development)


Build your legacy. Protect your moat. Own your mind.