diff --git a/docs/ai-tools-org-assessment.md b/docs/ai-tools-org-assessment.md new file mode 100644 index 00000000..08437686 --- /dev/null +++ b/docs/ai-tools-org-assessment.md @@ -0,0 +1,66 @@ +# AI Tools Org Assessment — Implementation Tracker + +**Issue:** #1119 +**Research by:** Bezalel +**Date:** 2026-04-07 +**Scope:** github.com/ai-tools — 205 repositories scanned + +## Summary + +The `ai-tools` GitHub org is a broad mirror/fork collection of 205 AI repos. +~170 are media-generation tools with limited operational value for the fleet. +7 tools are strongly relevant to our infrastructure, multi-agent orchestration, +and sovereign compute goals. + +## Top 7 Recommendations + +### Priority 1 — Immediate + +- [ ] **edge-tts** — Free TTS fallback for Hermes (pip install edge-tts) + - Zero API key, uses Microsoft Edge online service + - Pair with local TTS (fish-speech/F5-TTS) for full sovereignty later + - Hermes integration: add as provider fallback in text_to_speech tool + +- [ ] **llama.cpp** — Standardize local inference across VPS nodes + - Already partially running on Alpha (127.0.0.1:11435) + - Serve Qwen2.5-7B-GGUF or similar for fast always-available inference + - Eliminate per-token cloud charges for batch workloads + +### Priority 2 — Short-term (2 weeks) + +- [ ] **A2A (Agent2Agent Protocol)** — Machine-native inter-agent comms + - Draft Agent Cards for each wizard (Bezalel, Ezra, Allegro, Timmy) + - Pilot: Ezra detects Gitea failure -> A2A delegates to Bezalel -> fix -> report back + - Framework-agnostic, Google-backed + +- [ ] **Llama Stack** — Unified LLM API abstraction layer + - Evaluate replacing direct provider integrations with Stack API + - Pilot with one low-risk tool (e.g., text summarization) + +### Priority 3 — Medium-term (1 month) + +- [ ] **bolt.new-any-llm** — Rapid internal tool prototyping + - Use for fleet health dashboard, Gitea PR queue visualizer + - Can point at local Ollama/llama.cpp for sovereign prototypes + +- [ ] **Swarm (OpenAI)** — Multi-agent pattern reference + - Don't deploy; extract design patterns (handoffs, routines, routing) + - Apply patterns to Hermes multi-agent architecture + +- [ ] **diagram-ai / diagrams** — Architecture documentation + - Supports Alexander's Master KT initiative + - `diagrams` (Python) for CLI/scripted, `diagram-ai` (React) for interactive + +## Skip List + +These categories are low-value for the fleet: +- Image/video diffusion tools (~65 repos) +- Colorization/restoration (~15 repos) +- 3D reconstruction (~22 repos) +- Face swap / deepfake tools +- Music generation experiments + +## References + +- Issue: https://forge.alexanderwhitestone.com/Timmy_Foundation/the-nexus/issues/1119 +- Upstream org: https://github.com/ai-tools