ES / Español
Nexo Logo

User Manual

Complete guide for using the cognitive ecosystem and managing multimodal knowledge.

v2.0 · Ccom - G. F. · Apr 16, 2026
🌌
Vision
The Nexo ∞ Philosophy
Nexo is not just a tool; it is a cognitive amplifier. The system works on your documents to enrich them semantically and connect them through intelligent graphs.
Central Dashboard
Central Dashboard: Panoramic view of the status and Visual Performance Monitor.
Monitoring
📊
Performance
AI Health Monitor
Visualize in real-time resource consumption, latency, and success rate for each cloud call via intuitive progress bars.
Performance Bars

Understand at a glance which provider is working and how efficient its response is, optimizing your workflow.

First Steps
🚀
Configuration
Installation Protocol
Nexo guides your configuration through an automated 5-stage process to ensure perfect synchronization.
01
Profiling

Define your name and library theme (Literature, Technical, Research) to personalize the Dashboard.

02
Visual Engine

The system detects the presence of Obsidian, an essential requirement to render your knowledge graph.

03
Deployment

The Vault is automatically created in Documents/Nexo and necessary plugins are installed.

04
AI Power

API key linkage for the Hybrid AI Ecosystem. The system lights up when ready.

🔑
Access
Power Activation (API Keys)
For Nexo to audit and reason, it needs to connect to AI engines. (Note: Specific models may vary; the system always adapts to the best capacity and context available).

Deep Brain

Primary engine for mass analysis and deep audit of long documents (Large Context 128k).

Get Access →

Quick Response

Low-latency interface allowing near-instant chat responses.

Get Access →
Where to configure?

Open the .env file in the Nexo root and replace the values:

SAMBANOVA_API_KEY=your_key
GROQ_API_KEY=your_key
OPENROUTER_API_KEY=your_key
Daily Use
🔄
Processing
Work Cycle
The Nexo pipeline transforms your notes into structured knowledge in three key steps.
1. Resilience Filtering

Token savings through binary signatures and semantic similarity before using AI.

2. Intelligent Audit

Role assignment: Massive Ingestion (OpenRouter), Precision (SambaNova), and Chat (Groq).

3. Local Heuristics & Discovery

Short texts are processed locally with zero latency. Long docs generate Seeds and Blind Spots.

Nexo Bridge
🌉
Integration
Nexo Bridge for Obsidian
Connects Obsidian directly with Nexo via a native plugin. Note analysis, MemAtoms search, cognitive chat, and real-time connection status — all from your editor.
Commands (Ctrl+P)
  • Nexo: Analyze note — Sends the active note to the enrichment pipeline.
  • Nexo: Search MemAtoms — Retrieves semantic memories linked to cursor position.
  • Nexo: Check status — Verifies the connection with the local server.
Installation & Endpoints

Copy vault_template/.obsidian/plugins/nexo-bridge/ to your vault (requires Obsidian 0.15.0+).

Endpoints at localhost:8000:

  • /status — Server status
  • /analyze — Analyze note
  • /mematoms — Search memories
  • /ask — Cognitive chat
Connectivity Indicator:

The Bridge status is shown in the Nexo status bar. Green = active connection. If red, verify that port 8000 is free and that Nexo is running.

💬
Interaction
Smart Chat (RAG)
Ask your own documents. Nexo uses Retrieval-Augmented Generation (RAG) to respond using your own information.
Chat Interface
Intelligence Cache:

If you repeat a query, Nexo delivers the answer instantly without token consumption thanks to local storage of semantic findings.

🌐
Exploration
Visual Perspectives (MRV)
The Web Viewer offers 4 dimensions to navigate your knowledge universe.
  • 🎯 Radar: Projected ideas dashboard.
  • Radar
  • 🔷 Constellations: Grouping by genres.
  • Constellations
  • 🌱 Map: Interactive concentric graph.
  • Map
  • ◆ Hubs: Focus on themes and network connections.
  • Hubs
Continuity
🧠
Persistence
Smart Memory (AAAK)
Nexo now possesses "long-term memory." The system doesn't just process your notes; it learns from them and maintains a living context of your ideas.
MemAtoms: Memory Events

Every important finding is saved as a "MemAtom." If a piece of data is irrelevant, the Zero Filter automatically discards it to avoid noise.

Forgetting and Wisdom

The system applies "exponential forgetting" to what you don't use. Recurring themes are merged into deep Wisdom Notes.

Power Functions
🛠️
Control
Superior Command Center
Advanced management of system state and background optimizations.
Idle Mode

Activate idle mode for the AI to elevate the quality of your old documents, searching for deep themes while you're not using the application.

Advanced Functions
🧪
Laboratory
Obsidian Canvas & Discovery
Nexo uses Obsidian Canvas to create an argument tension map of your ideas.
Signals and Blind Spots

Visualize findings in green and knowledge gaps in red to audit your logic before writing.

MRV Synchronization

Ideas born in the web viewer materialize as editable nodes within your Obsidian laboratory.

Canvas
Canvas 1
Canvas 2
Knowledge Ingestion
📥
Import
Importing Documents into the Ecosystem
Nexo converts any external file into an enriched note in your library. The MarkItDown engine requires no external binaries and natively processes multiple formats (.pdf, .docx, .pptx, .xlsx, .epub).
01
Selection & Destination

Use the "Import Files" button. The system will prompt you to select the documents and assign the Thinking Space (Topic) where they should be stored.

02
Automatic Conversion

Nexo instantly converts the file to .md format, injecting a YAML frontmatter with the tag ai_status: raw (indicating it has not yet been analyzed).

03
Cognitive Enrichment

Run the "Analyze Documents" process. The AI pipeline will take these raw documents and extract their deep knowledge and MemAtoms.

Triple Filter (Token Savings)

Before using AI, the system verifies SHA-256 signatures and semantic similarity (ChromaDB >95%). Only genuinely new content will consume tokens.

🗂️
Organization
Thinking Spaces (Topics)
Organize your knowledge into independent thematic universes. Each Space has its own library, vector cache, and visualization data — completely isolated from others.
Unlimited Capacity

Create as many topics as you need: Physics, History, Projects, Research... No limit. Each topic automatically generates its folder structure in your local library.

Complete Isolation
  • Documents, cache, and vectors separated per topic.
  • The 3D viewer shows a badge with the active topic.
  • Analyze and export each topic independently.
Data Sovereignty
📡
Local
Local Node — Sovereign AI (Ollama)
Process your knowledge with total privacy and no internet dependency. Ollama allows running LLM models directly on your hardware. You must install Ollama from ollama.com before starting.
01
Access & Recommendation

Navigate to Side Menu → Advanced → Local Node Configuration. The system will audit your CPU/GPU and suggest the most efficient model to prevent bottlenecks.

02
Live Download

Select a model (e.g. Llama 3, Mistral, Qwen) and press Download. The download and unpacking progress is streamed in real-time in the bottom terminal.

03
Priority Activation

Once active, the Nexo router automatically prioritizes the Local Node for knowledge audits, applying an immediate switch without restarting (Hot-Reload).

⚠️ Hardware Requirements

7B models require a minimum of 8 GB RAM. 13B or higher models need 16 GB+. The panel will warn you if you try to load incompatible models.

Troubleshooting
🔧
Diagnosis
Troubleshooting Guide
Quick reference for the most common issues in the Nexo ecosystem.
Port 8000 in use

Another process is occupying the Bridge port. On Windows run netstat -ano | findstr :8000 to identify the process and close it via Task Manager.

Obsidian Vault not found

Verify Obsidian is installed. If auto-deployment failed, manually create the Documents/Nexo folder and restart Nexo.

Ollama not responding

Verify the Ollama service is running in the background. Run ollama list in your terminal to confirm available models.

ChromaDB corrupted

The vector database lives at biblioteca/vectores/. If corrupted, delete that folder — Nexo will regenerate it automatically on the next analysis (documents are not lost).

Invalid API Key

Keys are configured in the .env file at the Nexo root. Ensure there are no extra spaces and that the key is active in the provider's portal.

License Re-activation

If you change hardware (motherboard or system SSD), your Machine ID changes. Open a GitHub Issue with the subject "License Re-activation" to re-link your educational key.