# Nous Domain Reference

Generated on May 8, 2026. This folder is the uniform Oshun-local documentation
home for the Nous domain.

## Executive Summary

**Nous** provides local LLM inference, model management, embedding generation,
agent orchestration, document processing, and prompt engineering as consumable
library APIs for any application in the Oshun ecosystem.

## Documentation Contract

- [Feature Inventory](feature-inventory.md)
- [Implementation Map](implementation-map.md)

## Domain Profile

- Domain slug: `nous`
- Display name: Nous
- Aliases: None
- TODO phase coverage: `47`
- TODO phase titles: `Nous - Sovereign AI Platform`
- Repository status: Repository implementation exists under apps/libs/services.
- Oshun integration status: No Oshun shell references discovered yet.
- Source confidence: Implementation-backed and documentation-backed

## Evidence Profile

| Source                    | Status  | Notes                                  |
| ------------------------- | ------- | -------------------------------------- |
| Repository implementation | present | 19 app/lib/service entries discovered  |
| Standalone domain docs    | present | 8 entries under docs/domains/nous      |
| TODO phase coverage       | present | 1 mapped phase(s), 782 checklist items |
| Tests                     | absent  | 0 matching test files discovered       |
| Oshun integration         | absent  | 0 Oshun-local references discovered    |

## Capability Pillars

| Capability Pillar                                     | Primary Source                | Status                           |
| ----------------------------------------------------- | ----------------------------- | -------------------------------- |
| Hardware-Accelerated Inference                        | docs/domains/nous/features.md | implementation-backed            |
| Model Management                                      | docs/domains/nous/features.md | implementation-backed            |
| Inference Pipeline                                    | docs/domains/nous/features.md | implementation-backed            |
| Generation Control                                    | docs/domains/nous/features.md | implementation-backed            |
| Multi-Adapter Serving                                 | docs/domains/nous/features.md | implementation-backed            |
| Graph Optimization and Quantization                   | docs/domains/nous/features.md | implementation-backed            |
| Tensor Operations                                     | docs/domains/nous/features.md | implementation-backed            |
| Embedding Generation                                  | docs/domains/nous/features.md | implementation-backed            |
| Similarity Search                                     | docs/domains/nous/features.md | implementation-backed            |
| LLM Completion APIs                                   | docs/domains/nous/features.md | implementation-backed            |
| Natural Language Processing                           | docs/domains/nous/features.md | implementation-backed            |
| Prompt Engineering                                    | docs/domains/nous/features.md | implementation-backed            |
| Advanced Reasoning                                    | docs/domains/nous/features.md | implementation-backed            |
| Persona and Context Management                        | docs/domains/nous/features.md | implementation-backed            |
| Agent Architecture                                    | docs/domains/nous/features.md | implementation-backed            |
| Document Processing and RAG                           | docs/domains/nous/features.md | implementation-backed            |
| Computer Vision                                       | docs/domains/nous/features.md | implementation-backed            |
| Cross-Cutting Capabilities                            | docs/domains/nous/features.md | implementation-backed            |
| Capability Summary by Library                         | docs/domains/nous/features.md | implementation-backed            |
| Inference Engine                                      | TODOS.md phase 47             | planned-or-partially-implemented |
| LLM Serving                                           | TODOS.md phase 47             | planned-or-partially-implemented |
| Embedding Engine                                      | TODOS.md phase 47             | planned-or-partially-implemented |
| Text Generation                                       | TODOS.md phase 47             | planned-or-partially-implemented |
| Agent Framework                                       | TODOS.md phase 47             | planned-or-partially-implemented |
| RAG Pipeline                                          | TODOS.md phase 47             | planned-or-partially-implemented |
| Image Understanding                                   | TODOS.md phase 47             | planned-or-partially-implemented |
| Image Generation                                      | TODOS.md phase 47             | planned-or-partially-implemented |
| Video Understanding                                   | TODOS.md phase 47             | planned-or-partially-implemented |
| Video Generation                                      | TODOS.md phase 47             | planned-or-partially-implemented |
| Speech Recognition                                    | TODOS.md phase 47             | planned-or-partially-implemented |
| Speech Synthesis                                      | TODOS.md phase 47             | planned-or-partially-implemented |
| Music Generation                                      | TODOS.md phase 47             | planned-or-partially-implemented |
| Audio Processing                                      | TODOS.md phase 47             | planned-or-partially-implemented |
| Training Framework                                    | TODOS.md phase 47             | planned-or-partially-implemented |
| Fine-tuning                                           | TODOS.md phase 47             | planned-or-partially-implemented |
| RLHF Pipeline                                         | TODOS.md phase 47             | planned-or-partially-implemented |
| Data Pipeline                                         | TODOS.md phase 47             | planned-or-partially-implemented |
| Content Moderation                                    | TODOS.md phase 47             | planned-or-partially-implemented |
| Guardrails                                            | TODOS.md phase 47             | planned-or-partially-implemented |
| Alignment                                             | TODOS.md phase 47             | planned-or-partially-implemented |
| VOID Model Integration & Deployment                   | TODOS.md phase 47             | planned-or-partially-implemented |
| Quadmask Conditioning & Physics Consequence Detection | TODOS.md phase 47             | planned-or-partially-implemented |
| Multi-Pass Inference & Temporal Consistency           | TODOS.md phase 47             | planned-or-partially-implemented |
| Multi-Tier Model Routing & Alternatives               | TODOS.md phase 47             | planned-or-partially-implemented |
| Quality Metrics & Validation                          | TODOS.md phase 47             | planned-or-partially-implemented |
| Synthetic Training Data & Fine-Tuning                 | TODOS.md phase 47             | planned-or-partially-implemented |
| OminiControl for FLUX/DiT                             | TODOS.md phase 47             | planned-or-partially-implemented |
| ControlNeXt & ControlNet++                            | TODOS.md phase 47             | planned-or-partially-implemented |
| Spatial Layout & Grounding Control                    | TODOS.md phase 47             | planned-or-partially-implemented |
| Attention Manipulation & Zero-Shot Editing            | TODOS.md phase 47             | planned-or-partially-implemented |
| Instruction-Based & Granular Image Editing            | TODOS.md phase 47             | planned-or-partially-implemented |
| Reference Insertion & Multi-Image Consistency         | TODOS.md phase 47             | planned-or-partially-implemented |
| IC-Light & Image Relighting                           | TODOS.md phase 47             | planned-or-partially-implemented |
| Video & Scene Relighting via Diffusion                | TODOS.md phase 47             | planned-or-partially-implemented |
| Text-Driven 3DGS Editing & Relighting                 | TODOS.md phase 47             | planned-or-partially-implemented |
| VACE Unified Video Creation & Editing                 | TODOS.md phase 47             | planned-or-partially-implemented |
| Dense Motion Trajectory Control                       | TODOS.md phase 47             | planned-or-partially-implemented |
| Real-Time Interactive Motion Control                  | TODOS.md phase 47             | planned-or-partially-implemented |
| Camera Trajectory Control                             | TODOS.md phase 47             | planned-or-partially-implemented |
| Video-to-Video Editing via Image Diffusion            | TODOS.md phase 47             | planned-or-partially-implemented |
| Subject-Consistent Multi-Modal Video                  | TODOS.md phase 47             | planned-or-partially-implemented |
| DiT-Based Portrait Animation                          | TODOS.md phase 47             | planned-or-partially-implemented |
| Real-Time Portrait Animation                          | TODOS.md phase 47             | planned-or-partially-implemented |
| Audio-Driven Video Dubbing                            | TODOS.md phase 47             | planned-or-partially-implemented |
| Temporally-Aligned Video-to-Audio                     | TODOS.md phase 47             | planned-or-partially-implemented |
| Foley Sound Generation                                | TODOS.md phase 47             | planned-or-partially-implemented |
| Universal Any-to-Audio                                | TODOS.md phase 47             | planned-or-partially-implemented |
| Zero-Shot Speech Editing                              | TODOS.md phase 47             | planned-or-partially-implemented |
| Flow-Matching TTS Architectures                       | TODOS.md phase 47             | planned-or-partially-implemented |
| Real-Time Voice Style Conversion                      | TODOS.md phase 47             | planned-or-partially-implemented |
| Advanced Music Generation Control                     | TODOS.md phase 47             | planned-or-partially-implemented |
| Diffusion-DPO & Preference Optimization               | TODOS.md phase 47             | planned-or-partially-implemented |
| LyCORIS & LoRA Architecture Variants                  | TODOS.md phase 47             | planned-or-partially-implemented |
| Multi-LoRA Composition & Attribute Control            | TODOS.md phase 47             | planned-or-partially-implemented |
| Consistency Models & Few-Step Generation              | TODOS.md phase 47             | planned-or-partially-implemented |
| Training-Free Inference Acceleration                  | TODOS.md phase 47             | planned-or-partially-implemented |
| Real-Time Interactive Diffusion                       | TODOS.md phase 47             | planned-or-partially-implemented |
| High-Resolution Generation                            | TODOS.md phase 47             | planned-or-partially-implemented |
| Flow Matching Distillation                            | TODOS.md phase 47             | planned-or-partially-implemented |
| Joint Audio-Video Diffusion Architecture              | TODOS.md phase 47             | planned-or-partially-implemented |
| Multi-Asset Conditioning Framework                    | TODOS.md phase 47             | planned-or-partially-implemented |
| Scene Planning & Multi-Shot Generation                | TODOS.md phase 47             | planned-or-partially-implemented |
| Physics-Aware Video Generation                        | TODOS.md phase 47             | planned-or-partially-implemented |

## Coverage Snapshot

- Code footprint entries: 19
- Standalone domain doc entries: 8
- OpenAPI/API doc entries: 0
- Test evidence files: 0
- Oshun-specific references: 0

## Source Precedence

1. Actual repository implementation under `apps/`, `libs/`, `services/`, and
   `openapi/`
2. Checklist-derived scope from `TODOS.md`
3. Existing standalone domain docs under `docs/domains/nous/`
4. No feature claims are introduced without one of the sources above
