Distributed Agent Network

Project Master Guide & Dashboard

Network Nodes

HP Pavilion

OS: Arch Linux 64

Agent Name: "HP"

Role: Power Node Status: Planned

Dell Inspiron

OS: Omarchy (Arch)

Agent Name: "Dell"

Role: Power Node Status: Planned

Toshiba Laptop

OS: Omarchy (Arch)

Agent Name: "Toshiba"

Role: Power Node Status: Planned

Raspberry Pi 5

OS: RPi OS 64-bit

Agent Name: "Pi-Five"

Role: Power Node Status: Planned

Raspberry Pi 500

OS: RPi OS 64-bit

Agent Name: "Pi-Board"

Role: Power Node Status: Planned

Asus T100

OS: Debian 13

Agent Name: "Asus"

Role: Light Client Status: Planned

Core Tech Stack

1. The "Name"

Picovoice Porcupine

Custom, on-device wake word engine. Each agent gets its own `.ppn` model file to listen for its unique name.

2. The "Ears"

OpenAI Whisper (Local)

High-accuracy, local Speech-to-Text. Transcribes spoken commands into text. Use `faster-whisper` for performance.

3. The "Brain"

Ollama (Self-Hosted)

Runs powerful LLMs (Llama 3, Phi-3) locally. This is the 100% private, offline "brain" for the Power Nodes.

4. The "Voice"

Piper

Fast, high-quality, and lightweight local Text-to-Speech. Gives each agent a natural-sounding voice.

5. The "Glue"

Master Python Script + Config

A single Python script ties all components together. A unique `config.json` on each machine tells it which agent it is.


{
  "AGENT_NAME": "Asus",
  "WAKE_WORD_PATH": "/opt/agents/asus.ppn",
  "LLM_MODE": "remote",
  "LLM_API_URL": "http://192.168.1.100:11434/api/generate"
}
                    

Architecture

Power Node Flow (HP, Dell, Pi, etc.)

Mic Porcupine Whisper Ollama (Local) Piper Speaker

Light Client Flow (Asus T100)

Mic (Asus) Whisper (Asus) Network Ollama (on HP) Network Piper (Asus)

Master Checklist