Developer Documentation

Architecture &
Ecosystem

The full technical stack behind 4,444 sovereign AI agents β€” from React UI to Rust backend to Python AI engines.

⚑ Tauri v2πŸ¦€ Rust 2024β–² Next.js 16βš›οΈ React 19🐍 Python 3.11+πŸ¦™ OllamaπŸ€– ElizaOSπŸ’° x402
0AI Souls
0+MCP Tools
0Products Indexed
0MB Installer

πŸ—οΈ System Overview

A zero-trust AI desktop ecosystem where every NFT is a persistent AI personality with its own voice, memories, and 35+ tools β€” running entirely on your hardware.

🌐FrontendNext.js · React · R3F
β†’
βš™οΈTauri ShellRust Β· IPC Β· Keychain
β†’
🧠MCP EnginePython · 35+ Tools
β†’
πŸ¦™OllamaLocal LLM
β†’
πŸ€–ElizaOSAgent Framework

πŸ”§ Technology Stack

πŸ–₯️

Desktop Shell

Tauri v2 Β· Rust
v1.2.1β–Ύ
⚑

Frontend

Next.js 16 Β· React 19 Β· Three.js
β–Ύ
🧠

MCP Server

Python Β· FastMCP 3.1
PyPIβ–Ύ
πŸ¦™

Local Inference

Ollama Β· Groq Β· OpenAI-Compatible
β–Ύ
πŸ€–

Agent Framework

ElizaOS Β· Custom Plugin
MITβ–Ύ
πŸ’°

x402 Payment Layer

Coinbase Β· HTTP 402 Β· USDC
β–Ύ

πŸ“‚ Open Source

Everything is public. Inspect the code, fork it, build on it.

RepositoryLicenseStackLinks
πŸ–₯️ Desktop AppBSL 1.1Rust / JSGitLab
🧠 MCP ServerBSL 1.1PythonGitLab · PyPI
πŸ€– ElizaOS PluginMITTypeScriptGitLab
πŸ’° x402 ServerBSL 1.1PythonGitLab
πŸ“Š TCG Oracle ToolsMITPythonGitLab Β· PyPI
🌐 WebsiteMITNext.jsLive

πŸ“¦ Desktop App β€” v1.2.1

Cross-platform native installer. macOS is Apple-notarized.

Downloads Live

PlatformFormatSignedInstall
🍎 macOS (Apple Silicon).dmgβœ… NotarizedOpen DMG β†’ drag to Applications
🐧 Linux (Ubuntu/Debian).debβ€”sudo dpkg -i *.deb
🐧 Linux (Fedora/RHEL).rpmβ€”sudo rpm -i *.rpm
πŸͺŸ Windows (x64).exeβ€”Double-click β†’ follow installer

Features

πŸ—£οΈ AI

  • Soul Chat (persistent personality)
  • Brain Modes (research, creative, code)
  • Voice Engine (Kokoro TTS)
  • Soul Council (multi-agent debates)

πŸƒ Market Intelligence

  • TCG Card Grader (vision AI)
  • Monte Carlo pricing
  • eBay Market Oracle
  • 370K+ products indexed

🎬 Creative

  • Music Studio (ACE-Step)
  • Video Clipping (beat-sync)
  • PFP Extractor (DIS pipeline)
  • Meme Machine

πŸ‘” Business

  • 24-feature Business Pilot
  • AI phone answering
  • Invoice chaser
  • Lead capture

πŸ”Œ MCP Server

35+ tools via Model Context Protocol. Any MCP client can connect.

Install from PyPI
pip install undesirables-mcp-server

Tool Categories

πŸƒ TCG Oracle

  • grade_card β€” Multimodal vision
  • price_card β€” Stochastic pricing
  • search_market β€” eBay depth
  • arb_scan β€” Cross-platform

🧠 AI Engines

  • rag_query β€” Local RAG
  • code_execute β€” AST sandbox
  • voice_generate β€” Kokoro TTS
  • generate_3d β€” TripoSR

πŸ“Š Market Data

  • ebay_search β€” Browse API
  • nft_lookup β€” On-chain
  • soul_init β€” Soul matrix
  • emotion_read β€” Sentiment

πŸ” Security

  • verify_holder β€” ERC-721
  • purchase_license β€” On-chain
  • verify_soul β€” Crypto init
  • AST code sandboxing

πŸ’Έ x402 Micropayments

AI-to-AI commerce via Coinbase's x402 protocol. Agents pay with USDC β€” no API keys, no humans in the loop.

Agent β†’ 402 Payment Required β†’ Sign USDC β†’ Receive inference
POST /api/inference β†’ 402 Payment RequiredAgent signs USDC tx on Base β†’ attaches receiptPOST /api/inference + X-Payment β†’ 200 OK

Built on Coinbase's open x402 standard. USDC on Base β€” sub-cent transaction fees.


πŸ“Š Data & Research

PlatformDatasetRecords
πŸ€— HuggingFacetcg-market-intelligence370K+
πŸ“Š Kaggletcg-market-intelligence370K+
πŸ€— HuggingFaceTCG Oracle Demo (Space)Interactive

πŸ”’ Security Model

Zero-trust architecture. Your data never leaves your machine.

  • 🧠 Local Inference β€” All AI runs on your hardware. No data sent externally.
  • πŸ” OS Keychain β€” API keys encrypted via macOS Keychain / Windows Credential Manager.
  • πŸ›‘οΈ AST Sandbox β€” Code execution parses AST before running. No shell injection.
  • πŸ“ Path Confinement β€” File ops restricted to workspace. No system writes.
  • πŸ” CI/CD Scanning β€” Gitleaks secret detection on every push.
  • 🍎 Apple Notarized β€” macOS builds signed under Developer ID Application.

🌐 Discovery & Standards

EndpointStandardPurpose
llms.txtllmstxt.orgLLM-readable project summary
ai-plugin.jsonOpenAI PluginChatGPT / agent discovery
agent.jsonACPAgent Commerce Protocol
The Undesirables β€” 4,444 NFTs on Ethereum