p2pwiki-ai/README.md

P2P Wiki AI

AI-augmented system for the P2P Foundation Wiki with two main features:

1. Conversational Agent — Ask questions about 23,000+ wiki articles using RAG (Retrieval Augmented Generation)
2. Article Ingress Pipeline — Drop article URLs to automatically analyze content, find matching wiki articles, and generate drafts

Content (wiki articles, XML dumps, infrastructure configs) lives in a separate repo: p2pfoundation-wiki

Quick Start

Prerequisites

• Python 3.10+
• Ollama installed locally (or access to a remote Ollama server)
• Optional: Anthropic API key for Claude (higher quality article drafts)

Install & Run

pip install -e .

# Parse wiki content (from XML dumps or articles directory)
python -m src.parser

# Generate embeddings
python -m src.embeddings

# Start server
python -m src.api

Visit http://localhost:8420/ui for the web interface.

Content Directory

By default, the system looks for xmldump/ and articles/articles/ in the project root. To point at the separate content repo:

# In .env
CONTENT_DIR=/path/to/p2pfoundation-wiki

Or mount via Docker:

HOST_XMLDUMP_DIR=/opt/content/p2pfoundation-wiki/xmldump docker compose up -d

Docker Deployment

docker compose up -d --build
docker compose logs -f

Configuration

Copy .env.example to .env and configure:

Variable	Default	Description
CONTENT_DIR	(unset)	Path to content repo (resolves xmldump + articles)
HOST_XMLDUMP_DIR	./xmldump	Host path for XML dump volume mount
OLLAMA_BASE_URL	http://localhost:11434	Ollama server URL
OLLAMA_MODEL	llama3.2	Model for chat Q&A
CLAUDE_MODEL	claude-sonnet-4-20250514	Model for article drafts
USE_CLAUDE_FOR_DRAFTS	true	Route drafts to Claude
USE_OLLAMA_FOR_CHAT	true	Route chat to Ollama
ANTHROPIC_API_KEY	(unset)	Claude API key (or via Infisical)

API Endpoints

Endpoint	Method	Description
/chat	POST	Ask questions about wiki content
/ingress	POST	Process external article URL
/review	GET	List items in review queue
/review/action	POST	Approve/reject draft
/search	GET	Direct vector search
/articles	GET	List article titles
/health	GET	Health check

License

The AI system code is provided as-is for educational purposes. Wiki content is from the P2P Foundation under CC BY-SA 3.0.