Mascarade

"The machine is us, our processes, an aspect of our embodiment." — Donna Haraway

Multi-machine agentic LLM orchestration platform. Mascarade routes prompts across 8+ providers (Claude, Mistral, OpenAI, Ollama, llama.cpp, MLX, Bedrock, and more), runs a decentralized P2P mesh across 5 physical nodes, fine-tunes domain-specific mini-models that beat HuggingFace baselines by +162%, and exposes MCP tools for hardware engineering workflows. Not a framework — a distributed organism running in production.

Documentation

---

Architecture

graph TD
    Client["Clients (curl, SDK, MCP, Xcode)"] --> API["API Gateway\nHono :3100\nAuth, Rate Limit, OpenAI compat"]
    API --> Core["Core Engine\nFastAPI :8100\nRouter, Agents, Orchestrator"]
    Core --> Providers["8+ LLM Providers\nClaude, Mistral, OpenAI, Google\nOllama, llama.cpp, MLX, Bedrock"]
    Core <--> P2P["P2P Mesh :4001\nEd25519 auth, DHT, PubSub"]
    P2P --- N1["GrosMac\nApple M5"]
    P2P --- N2["Tower\nCPU inference"]
    P2P --- N3["KXKM-AI\nRTX 4090"]
    P2P --- N4["VM\nDocker host"]
    P2P --- N5["CILS\nOllama inference"]
    Core <--> RAG["RAG Pipeline\nbge-m3 + Qdrant + SearXNG"]
    Core <--> MCP["MCP Server + Client\nKiCad, SPICE, FreeCAD"]

---

Key Features

Routing

• 8+ LLM providers with strategy-based selection (BEST / CHEAPEST / FASTEST)
• Fallback chains, ML router (softmax classifier, 17 features), Ollama multi-machine routing

P2P Mesh

• Ed25519 authentication, DHT discovery, PubSub messaging
• Capability-based task routing, NAT relay traversal, 5 active nodes

Agents

• 10+ builtin agents, domain agents (KiCad, SPICE, FreeCAD, component search)
• Plan-and-execute orchestrator with task decomposition and dependency management

Fine-tuning

• Teacher-to-student distillation pipeline: CPT, SFT, RLVR
• Unsloth + SimPO + LoRA/QLoRA, 29 domain-specific models on HuggingFace
• +162% vs HuggingFace #1 electronics model on 130-prompt benchmark

RAG

• bge-m3 embeddings, Qdrant hybrid search (dense + BM25 + RRF)
• LLM reranking, CRAG fallback, SearXNG web search

MCP

• Server: 5 tools exposed via Model Context Protocol
• Client: KiCad (5 tools), SPICE (28 tools), FreeCAD, n8n, ERPNext

Observability

• Langfuse (LLM traces), Prometheus + Grafana (metrics), OpenTelemetry (distributed tracing)

API Compatibility

• OpenAI /v1/chat/completions, Ollama /api/chat, Xcode Intelligence
• Drop-in replacement for Continue.dev, Open WebUI, LM Studio

---

Quickstart

git clone https://github.com/electron-rare/mascarade.git
cd mascarade
cp .env.example .env          # add your API keys
docker compose --profile core up -d
curl http://localhost:3100/v1/models

---

Fine-tuned Models

29 domain-specific models published on HuggingFace (clemsail), trained on 498K+ curated examples across electronics engineering domains.

Data quality pipeline: SemDeDup, IFD scoring, multi-judge (3 LLMs), capability scoring. Full list on HuggingFace.

---

Benchmarks

Evaluated by Codestral judge on 130 prompts (100 standard + 30 adversarial), electronics engineering domain:

Mascarade fine-tunes outperform the top HuggingFace electronics model by +162% while being smaller than the base model.

---

Related Projects

Services

Agents production (9)

---

La Suite Numerique (DINUM) -- 8 services

Integration avec l'ecosysteme souverain francais. SSO unifie via Keycloak (auth.saillant.cc, realm electron_rare), avec callback OAuth partage sur https://auth.saillant.cc/_oauth.

Repos de reference : numerique-gouv, suitenumerique

Pour l'integration applicative, Open Buro expose POST /openburo/files/resolve-open afin de preferer une ouverture dans l'editeur adapte quand le type de fichier est editable dans la suite, sinon basculer vers Drive, puis seulement vers un telechargement explicite. Cette route est le point de passage obligatoire pour l'ouverture documentaire; l'UI ne doit pas ouvrir des URLs brutes. Le repo expose aussi GET /openburo/files/resolve-open, GET /openburo/files/by-business-object, l'alias GET /files/by-business-object, ainsi que POST /dolibarr/sync/customer, POST /dolibarr/sync/invoice et POST /dolibarr/sync/proposal pour garder Dolibarr comme referentiel metier et deleguer la resolution documentaire a Mascarade.

---

License

MIT — Copyright (c) 2026 L'Electron Rare

---

"The cyborg does not dream of community on the model of the organic family. It is not made of mud and cannot dream of returning to dust."