Files
Kill_LIFE/docs/references/github_ecosystem_map.md
L'électron rare 066acde0cb docs: add feature maps, audits, research, plans lots 19-26
- Feature maps: agentic intelligence, digital factory, yiacad global/UI/UX/backend
- Audits: consolidation, refactor manifest, exhaustive refonte
- Research: OSS AI-native CAD, digital factory stack, mascarade observability
- Plans: lots 19-26 (mesh tri-repo, UI/UX refonte, yiacad global,
  intelligence agentique, mistral agents/studio, hypnoled, EDA AI tools,
  git EDA platform)
- Operator docs: machine registry, alignment, sync status, provider compat
- Mascarade/Kill_LIFE product contracts and OPS bridge
- PCB AI fab integration map, artifact WMS index
- References directory

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-24 00:20:32 +01:00

227 lines
10 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Cartographie GitHub — Écosystème Multi-LLM Mascarade
> **Dernière MAJ**: 2026-03-22 (session 13 — +2 providers EDA, +1 agent kicad-happy)
> **Objectif**: Référencer les repos GitHub officiels des providers et outils pertinents pour l'infrastructure Mascarade + Kill_LIFE
---
## 🔷 Anthropic — github.com/anthropics (77 repos)
### SDKs (providers Mascarade)
| Repo | Stars | Langage | Usage Mascarade |
|------|-------|---------|-----------------|
| **anthropic-sdk-python** | 3.0k | Python | Provider `claude.py` — SDK principal |
| **anthropic-sdk-typescript** | 1.7k | TypeScript | Frontend/API gateway |
| **anthropic-sdk-go** | 918 | Go | — |
| **anthropic-sdk-java** | 260 | Kotlin | — |
| **anthropic-sdk-csharp** | 192 | C# | — |
| **anthropic-sdk-php** | 118 | PHP | — |
| **anthropic-sdk-ruby** | 309 | Ruby | — |
### Agents & Tools
| Repo | Stars | Description | Pertinence |
|------|-------|-------------|------------|
| **skills** | 99.3k | Public Agent Skills registry | Skills de référence pour Kill_LIFE agents |
| **claude-code** | 81k | CLI coding agent (Shell) | Outil de dev principal |
| **claude-agent-sdk-python** | 5.6k | SDK agents Python | Potentiel orchestrateur alternatif Mascarade |
| **claude-code-action** | 6.4k | GitHub Actions CI/CD | CI Kill_LIFE / Mascarade |
| **claude-plugins-official** | 13.9k | Plugin directory officiel | Référence plugins Kill_LIFE |
### Ressources & Learning
| Repo | Stars | Description |
|------|-------|-------------|
| **claude-cookbooks** | 35.6k | Notebooks/recettes Claude |
| **prompt-eng-interactive-tutorial** | 33.9k | Tutoriel prompt engineering |
| **courses** | 19.7k | Cours éducatifs Anthropic |
| **claude-quickstarts** | 15.5k | Quickstart apps déployables |
### Anthropic Platform configuré
| Élément | Valeur |
|---------|--------|
| Organisation | L'électron rare |
| Plan | Evaluation access (free tier) |
| Workspace | Default |
| Clé mascarade-router | `sk-ant-api03-bEo...hQAA` ✅ |
| Clé kill-life-governance | `sk-ant-api03-xKJ...zQAA` ✅ |
---
## 🟢 OpenAI — github.com/openai (234 repos)
### SDKs (providers Mascarade)
| Repo | Stars | Langage | Usage Mascarade |
|------|-------|---------|-----------------|
| **openai-python** | 30.3k | Python | Provider `openai.py` — SDK principal |
| **openai-node** | 10.8k | TypeScript | Frontend/API |
| **openai-go** | 3.1k | Go | — |
| **openai-java** | 1.4k | Kotlin | — |
### Agents
| Repo | Stars | Description | Pertinence |
|------|-------|-------------|------------|
| **codex** | 66.8k | CLI coding agent (Rust) | Concurrent Claude Code |
| **openai-agents-python** | 20.2k | Multi-agent framework Python | Référence pour architecture agents Mascarade |
| **openai-agents-js** | 2.5k | Multi-agent framework JS | — |
| **plugins** | 74 | OpenAI Plugins | Plugin architecture ref |
### Outils & ML
| Repo | Stars | Description | Pertinence |
|------|-------|-------------|------------|
| **whisper** | 96.4k | Speech Recognition | Potentiel module voix Mascarade |
| **tiktoken** | 17.6k | BPE tokenizer rapide | Token counting dans router |
| **evals** | 18k | Framework d'évaluation LLM | Benchmark T-MA-021 |
| **openai-cookbook** | 72.3k | Guides & exemples API | Recettes Responses API |
### Projets OpenAI Platform configurés
| Projet | ID | Clé |
|--------|----|-----|
| Default | `proj_OwtOT7Ws1BtPVsKFkuI3VFpM` | — |
| Mascarade | `proj_Z6TszEfikDtBSfn5rIeaJnQI` | mascarade-router |
| Kill_LIFE | `proj_CYBNMcd3L1ml9IZHC1tqdpQh` | kill-life-governance |
---
## 🟠 Mistral AI — github.com/mistralai (24 repos)
### SDKs (providers Mascarade)
| Repo | Stars | Langage | Usage Mascarade |
|------|-------|---------|-----------------|
| **client-python** | 716 | Python | Provider `mistral.py` + `mistral_agents.py` — SDK principal |
| **client-ts** | 131 | TypeScript | — |
### Inference & Fine-tune
| Repo | Stars | Description | Pertinence |
|------|-------|-------------|------------|
| **mistral-inference** | 10.7k | Lib inférence locale (Jupyter) | Référence formats modèles |
| **mistral-finetune** | 3.1k | Pipeline fine-tune officiel | **T-MA-016/017** — fine-tune KiCad/SPICE |
| **mistral-common** | 871 | Preprocessing/tokenization | Token counting Mistral |
### Agents & Tools
| Repo | Stars | Description | Pertinence |
|------|-------|-------------|------------|
| **mistral-vibe** | 3.6k | CLI coding agent Python | Concurrent Claude Code / Codex |
| **agent-client-protocol** | 4 | Fork ACP (éditeur↔agent) | Protocol standard agents |
| **cookbook** | 2.2k | Recettes Mistral | Exemples Beta API |
### Agents AI Studio configurés
| Agent | ID | Modèle | Temp |
|-------|----|--------|------|
| Sentinelle | `ag_019d124c...` | mistral-medium-latest | 0.1 |
| Tower | `ag_019d124e...` | magistral-medium-latest | 0.4 |
| Forge | `ag_019d1251...` | codestral-latest | 0.21 |
| Devstral | `ag_019d1253...` | devstral-latest | 0.17 |
### Divers
| Repo | Description |
|------|-------------|
| **platform-docs-public** (MDX) | Docs API publiques |
| **prom_client_python** (fork Prometheus) | Monitoring instrumenté |
| **zed-extensions** (fork Zed) | Extension éditeur Zed |
| **megablocks-public** (archive, fork Databricks) | MoE sparse training |
| **flyte** (fork Flyteorg) | Workflow orchestration |
---
## 📊 Comparatif CLI Agents (coding tools)
| Outil | Org | Stars | Langage | Licence |
|-------|-----|-------|---------|---------|
| **skills** | Anthropic | 99.3k | Python | — |
| **claude-code** | Anthropic | 81k | Shell | — |
| **codex** | OpenAI | 66.8k | Rust | Apache-2.0 |
| **mistral-vibe** | Mistral | 3.6k | Python | Apache-2.0 |
## 📊 Comparatif Agent Frameworks
| Framework | Org | Stars | Description |
|-----------|-----|-------|-------------|
| **claude-agent-sdk-python** | Anthropic | 5.6k | SDK agents Claude |
| **openai-agents-python** | OpenAI | 20.2k | Multi-agent workflows |
| **openai-agents-js** | OpenAI | 2.5k | Multi-agent JS |
| *(Conversations Beta API)* | Mistral | — | Agents via API Studio |
---
## 🔗 Mapping providers Mascarade → GitHub repos
```
mascarade/router/providers/
├── claude.py → anthropics/anthropic-sdk-python
├── openai.py → openai/openai-python
├── mistral.py → mistralai/client-python
├── mistral_agents.py → mistralai/client-python + Beta Conversations API
├── google.py → google (Gemini SDK)
├── bedrock.py → AWS SDK (boto3)
├── huggingface.py → huggingface_hub
├── ollama.py → ollama/ollama-python
├── llama_cpp.py → local inference
├── apple_coreml.py → coremltools
├── kicad_router.py → custom KiCad routing
├── pcbdesigner.py → planned provider path in active repo (T-EDA-001, Plan 26)
└── quilter.py → planned provider path in active repo (T-EDA-002, Plan 26)
mascarade/agents/
├── kicad_agent.py → KiCad schematic/PCB agent
├── kicad_happy_agent.py → planned agent path in active repo for BOM/LCSC/DFM (T-EDA-003, Plan 26)
├── spice_agent.py → LTspice simulation agent
├── components_agent.py → Component sourcing agent
└── freecad_agent.py → FreeCAD 3D/mechanical agent
```
---
## 💰 Synthèse Billing — Infrastructure Multi-LLM (22 mars 2026)
| Provider | Plan | Crédits | Billing | Limites clés |
|----------|------|---------|---------|--------------|
| **Mistral** | Le Chat Team (59,98 €/mois) + AI Studio Scale | 0,00 € (pay-as-you-go) | Visa ****-2046 | 6 RPS, 2M TPM, 10B tokens/mois, fine-tune ✅ |
| **OpenAI** | Pay as you go | **$50.00** | Auto-recharge ON ($25@$15) | Standard tier |
| **Anthropic** | Evaluation access (free) | **0** (nécessite achat) | — | 5 RPM, 10K input TPM, 4K output TPM |
### Providers Mascarade — Statut opérationnel
| Provider | Fichier | SDK | Clé API | Statut |
|----------|---------|-----|---------|--------|
| `claude.py` | ClaudeProvider | anthropic SDK | mascarade-router (sk-ant-...hQAA) | ✅ Validé (crédits requis) |
| `openai.py` | OpenAIProvider | openai SDK | mascarade-router (sk-proj-...) | ✅ Opérationnel ($50) |
| `mistral.py` | MistralProvider | mistralai SDK | mascarade-router (708z...7kG) | ✅ Connectivité validée |
| `mistral_agents.py` | MistralAgentsProvider | httpx (Beta API) | mascarade-router (708z...7kG) | ✅ 4 agents v2 — validé |
| `pcbdesigner.py` | PCBDesignerProvider | aiohttp (REST) | `PCBDESIGNER_API_KEY` (a configurer) | 🟡 Planned, not implemented in active Mascarade repo |
| `quilter.py` | QuilterProvider | aiohttp (REST) | `QUILTER_API_KEY` (a configurer) | 🟡 Planned, not implemented in active Mascarade repo |
---
## Actions suivantes
1. **mistral-finetune** → Cloner et tester pour T-MA-016/017 (fine-tune KiCad/SPICE datasets)
2. **openai evals** → Adapter framework pour benchmark T-MA-021
3. **claude-agent-sdk-python** → Évaluer comme orchestrateur alternatif au router Mascarade
4. **tiktoken** → Intégrer token counting OpenAI dans le router (estimation coûts)
5. **openai-agents-python** → Étudier patterns multi-agent pour A2A protocol (T-MA-030)
6. **Acheter crédits Anthropic** → Nécessaire pour activer le provider Claude en production
---
## 🟣 Outils EDA+IA — Providers spécialisés PCB (Plan 26)
| Outil | Type Mascarade | API / Source | Approche | Temps typique |
|-------|---------------|-------------|----------|---------------|
| **PCB Designer AI** | Provider | REST `api.pcbdesigner.ai/v1` | IA placement+routing → Gerber → JLCPCB one-click | 30min2h |
| **Quilter** | Provider | REST `api.quilter.ai/v1` | Physique+RL, multi-candidat, scores SI/thermal/DFM | 26h |
| **kicad-happy** | Agent | GitHub (Claude Code skills) | Analyse schéma/PCB, BOM extract, sourcing LCSC, DFM | Secondes |
| **KiCad Router** | Provider (existant) | Autorouter KiCad interne | Routage offline local | Minutes |
### Pipeline chaine cible (T-EDA-022)
```
kicad-happy (analyse+BOM) → quilter (routage physique) → pcbdesigner (commande JLCPCB)
```
Note de realite:
- cette chaine est une cible d'architecture
- elle n'est pas implementee dans le repo Mascarade actif au 2026-03-22
- aucun provider/agent EDA n'est considere `done` tant que le fichier n'existe pas dans `/Users/electron/Documents/Projets/mascarade`
Canonical mapping and adoption notes:
- `docs/PCB_AI_FAB_INTEGRATION_MAP_2026-03-22.md`
- `specs/contracts/pcb_ai_fab_registry.json`
- `tools/cockpit/pcb_ai_fab_tui.sh`