Skip to content

# NEXA Documentation

Neural Nexus for Information & Automation — the central nervous system that ties Memos, n8n, SAIA (LiteLLM), Nextcloud and a vector store into one assistant.

This is the documentation entry point. Read top-to-bottom for first-time setup, or jump to the section you need.

## Table of Contents

# | Document | Read when…
--- | --- | ---
01 | Vision & Scope | You want to understand what Nexa is and isn't.
02 | Roadmap & Phases | You want to know the implementation order.
03 | Architecture Overview | You need a one-page mental model.
04 | Integration Matrix | You're wiring up a new data source or mapping work-vs-personal flows.
05 | Command System | You want to know what `#nexa:*` commands do.
06 | Classification Logic | You're tuning the work/personal router.
07 | Workflow Spec — Task Router | You're building the Phase-2 router workflow.
08 | GraphRAG Architecture | You're working on Phase 3 (Qdrant + Graph).
09 | Deployment | You're bringing Nexa up on the real infrastructure.
10 | Operations | You need backup, monitoring or troubleshooting.
11 | Open Questions (user-info-required) | Items the user still has to answer before progress.
12 | Optimization Opportunities | Ideas worth considering for the wider homelab.
13 | Information Wishlist | What additional system inventory would sharpen future decisions.

## Reading paths

- First-time installer: 01 → 03 → 09 → 10 → 11
- Workflow author: 04 → 05 → 07 → 06
- Phase-3 work (memory): 08 → 09 (§ Phase 3 add-on)
- Stakeholder / quick read: 01 → 02 → 12

## Repository layout

    nexa/
    ├── README.md                  → points here
    ├── docs/                      → you are here
    └── nexa-core/                 → the actual project
        ├── ai-prompts/            → SAIA system prompts
        ├── config/                → runtime config (YAML, JSON schema)
        ├── n8n-workflows/         → exported workflows, version-controlled
        └── scripts/               → automation helpers

Source-of-truth for runnable config stays in `nexa-core/`. Documentation lives here in `docs/`.