nexi-architecture

Maps the Nexi voice assistant codebase layers from wake detection through intent routing to UI.

Updated Jun 22, 2026
One-click install
npx skills add https://github.com/aicodepro/ai-agent-nexi --skill nexi-architecture-aicodepro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nexi-architecture
Source: https://github.com/aicodepro/ai-agent-nexi/tree/main/.opencode/skills/nexi-architecture
Command: npx skills add https://github.com/aicodepro/ai-agent-nexi --skill nexi-architecture-aicodepro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Navigating the Nexi voice assistant codebase is difficult because logic is spread across many engine modules for wake detection, ASR, intent routing, tools, and UI. This Skill provides an architecture map so you can orient quickly and trace any feature end to end. ## Core Features & Use Cases - Layer-by-layer codebase map: Documents where wake/audio, ASR, intent routing, model selection, tools, brain, agency, forge, Claude Code driver, and UI bridge code lives under engine/. - Provider boundary conventions: Clarifies that Groq handles ASR and intent while Gemini handles chat and vision, and warns against confusing Groq with xAI's Grok. - Tool registration rules: Explains that a tool must appear in _TOOLS, ALLOWED_INTENTS, and TOOL_INTENTS in engine/tool_registry.py or it silently fails to route. - Use Case: When adding a new desktop automation capability, use this Skill to learn that you must register it in tool_registry.py across three structures and route it through groq_intent_router_v2.py. ## Quick Start Ask the assistant to explain where the intent routing logic lives in the Nexi codebase and how a voice command flows from wake detection to a spoken response.

Frequently Asked Questions about nexi-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new tool to the Nexi voice assistant?

Register the tool in engine/tool_registry.py by adding it to _TOOLS, ALLOWED_INTENTS, and TOOL_INTENTS. If any of the three entries is missing, the tool silently fails to route through the intent system.

Where does intent routing happen in the Nexi codebase?

Intent routing lives in engine/groq_intent_router_v2.py, a tiered router using semantic embeddings, then a small model, then a large model, with a compound ReAct branch. Multi-step tool use is handled by engine/react_planner.py.

What is the difference between Groq and Gemini usage in Nexi?

Groq (groq.com) handles ASR via Whisper and intent routing, while Gemini handles chat, vision, and reasoning in engine/gemini_brain.py. Grok from xAI is a separate optional provider and should not be confused with Groq.

Why does the Nexi clap detection use the DSP backend instead of the CNN backend?

The CNN backend in engine/clap_nn_backend.py is wired but dormant because no trained model exists yet. The DSP backend in engine/dsp_clap_backend.py is the live path for double-clap wake detection.

How does Nexi avoid sending silent audio to the Groq Whisper API?

engine/groq_asr.py includes an audio quality gate (_audio_has_speech) that skips the API call for short or silent clips, plus a hallucination filter (_is_hallucination) that drops Whisper's known silence-echo phrases.