Add initial project documentation

This commit is contained in:
Storme-bit
2026-04-04 05:22:36 -07:00
parent 41a8bb3875
commit ebbeecfa1a
8 changed files with 256 additions and 0 deletions

View File

@@ -0,0 +1,42 @@
# Homelab Deployment
## Overview
NexusAI is distributed across three nodes. Each node runs only the
services appropriate for its hardware.
## Mini PC 1 — 192.168.0.81
Runs: Qdrant, Memory Service, Embedding Service
```bash
ssh username@192.168.0.81
cd ~/nexusai
docker compose -f docker-compose.mini1.yml up -d # Qdrant
npm run memory
npm run embedding
```
## Mini PC 2 — 192.168.0.205
Runs: Gitea, Orchestration Service
```bash
ssh username@192.168.0.205
cd ~/gitea
docker compose up -d # Gitea
cd ~/nexusai
npm run orchestration
```
## Main PC
Runs: Ollama, Inference Service
```bash
ollama serve
npm run inference
```
## Environment Files
Each node needs a `.env` file in the relevant service package directory.
These are not committed to git. See each service's documentation for
required variables.