docs: add AI stack to README.md

Updated README.md with AI intelligence system:

**Core Systems Table**:
- Added AI system entry with ai.pivoine.art access point

**Infrastructure Section**:
- Added AI Intelligence Core with PostgreSQL 16 + pgvector
- Listed Open WebUI, Crawl4AI, and document embeddings

**Navigation Commands**:
- New AI Operations section with usage instructions
- How to configure Claude API in Open WebUI
- Steps: create account, add API connection, select model, upload docs
- Internal services documentation (Crawl4AI, PostgreSQL)
- n8n workflow integration examples

**Ship Architecture**:
- Added AI Intelligence category with 3 services
- PostgreSQL+pgvector for vector database
- Open WebUI for Claude interface
- Crawl4AI for web scraping (internal)

**Storage Volumes**:
- ai_postgres_data: AI vector database
- ai_webui_data: Open WebUI application data
- ai_crawl4ai_data: Web scraping cache

**Backup Protocol**:
- Updated backup window to 2-10 AM
- Updated count from 11 to 16 backup plans

All AI services accessible at https://ai.pivoine.art with Claude
integration, RAG support, and web search capabilities.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
2025-11-08 22:49:39 +01:00
parent ec12efb3f1
commit d5a3d26c97

View File

@@ -57,6 +57,7 @@ The **Falcon** is a state-of-the-art containerized starship, powered by Docker's
| **KIT** | *Toolkit hub with converter, editor & colors* | [kit.pivoine.art](https://kit.pivoine.art) |
| **JELLY** | *Media streaming server* | [jelly.pivoine.art](https://jelly.pivoine.art) |
| **DROP** | *Peer-to-peer file sharing* | [drop.pivoine.art](https://drop.pivoine.art) |
| **AI** | *Claude AI with RAG & web scraping* | [ai.pivoine.art](https://ai.pivoine.art) |
| **RESTIC** | *Automated backup vault system* | [restic.pivoine.art](https://restic.pivoine.art) |
| **NETDATA** | *Real-time ship diagnostics & alerts* | [netdata.pivoine.art](https://netdata.pivoine.art) |
| **PROXY** | *Shield control dashboard* | [proxy.pivoine.art](https://proxy.pivoine.art) |
@@ -78,7 +79,14 @@ The **Falcon** is a state-of-the-art containerized starship, powered by Docker's
│ ├─ Umami Analytics Vault │
│ ├─ n8n Workflow Engine Database │
│ ├─ Linkwarden Bookmark Archive │
─ Joplin Note-taking Server Database │
─ Joplin Note-taking Server Database │
│ └─ Mattermost Team Chat Database │
├─────────────────────────────────────────────────┤
│ 🤖 AI INTELLIGENCE CORE (PostgreSQL 16) │
│ ├─ pgvector extension for RAG operations │
│ ├─ Open WebUI with Claude integration │
│ ├─ Crawl4AI web scraping service │
│ └─ Document embeddings & semantic search │
├─────────────────────────────────────────────────┤
│ ⚡ REDIS CACHE HYPERDRIVE │
│ └─ Warp-speed data acceleration │
@@ -235,6 +243,41 @@ arty env/sync
# - Programmatic API access
```
### AI Operations (AI System)
```bash
# Access Open WebUI with Claude integration
# URL: https://ai.pivoine.art
# Features:
# - ChatGPT-like interface with Claude AI
# - Upload documents for RAG (Retrieval-Augmented Generation)
# - Web search for current information
# - pgvector-powered semantic search
# - Email notifications via SMTP
# - n8n workflow integration
# How to use:
# 1. Visit https://ai.pivoine.art and create an account
# 2. In Settings → Connections, add Claude API:
# - Name: Anthropic Claude
# - API Base URL: https://api.anthropic.com/v1
# - API Key: (your Anthropic API key)
# 3. Select Claude model in chat (claude-3-5-sonnet-20241022)
# 4. Upload documents in Knowledge → Files for RAG
# 5. Start chatting with AI-enhanced responses
# Internal services:
# - Crawl4AI scraping API: http://ai_crawl4ai:11235 (container network)
# - AI PostgreSQL with pgvector: ai_postgres:5432
# - Database: openwebui (user: ai)
# Integration with n8n:
# - Create workflows that use Crawl4AI for web scraping
# - Trigger AI tasks via webhooks
# - Send results to Mattermost notifications
```
### Backup Operations (RESTIC System)
```bash
@@ -292,9 +335,15 @@ THE FALCON (falcon_network)
│ ├─ Kit Toolkit [vert.kit.pivoine.art, paint.kit.pivoine.art, pastel.kit.pivoine.art]
│ ├─ Jellyfin Media [jelly.pivoine.art]
│ ├─ PairDrop Sharing [drop.pivoine.art]
│ ├─ Open WebUI AI [ai.pivoine.art]
│ ├─ Backrest Backups [restic.pivoine.art]
│ └─ WireGuard VPN [vpn.pivoine.art]
├─ 🤖 AI INTELLIGENCE
│ ├─ PostgreSQL+pgvector [Internal] → Vector Database
│ ├─ Open WebUI [ai.pivoine.art] → Claude Interface
│ └─ Crawl4AI [Internal:11235] → Web Scraper
└─ 💾 STORAGE VOLUMES
├─ postgres_data → Critical mission data
├─ directus_uploads → Alien encounter evidence
@@ -309,6 +358,9 @@ THE FALCON (falcon_network)
├─ vaultwarden_data → Encrypted password vault
├─ joplin_data → Note-taking server data
├─ jelly_config → Jellyfin media server config
├─ ai_postgres_data → AI vector database
├─ ai_webui_data → Open WebUI application data
├─ ai_crawl4ai_data → Web scraping cache
├─ backrest_data → Backup system state
├─ backrest_config → Backup configurations
└─ letsencrypt_data → Shield certificates
@@ -357,8 +409,8 @@ THE FALCON (falcon_network)
└─ VPN cloaking device enabled
💾 BACKUP PROTOCOL
├─ Automated daily backups (2-8 AM)
├─ 11 backup plans covering all volumes
├─ Automated daily backups (2-10 AM)
├─ 16 backup plans covering all volumes
├─ Retention: 7 daily, 4 weekly, 3-12 monthly
├─ Encrypted restic repositories
├─ Weekly maintenance (prune & integrity check)