How musabj1917-oss/verbose-ai works
Verbose AI is a book-reading and comprehension platform: readers ask questions or take book-derived quizzes, with answers grounded in retrieved passages and citations. Admins can curate books through the web console or CLI; embeddings enable semantic retrieval in pgvector. The PHP app also exposes an MCP interface for external clients. The graph follows documented capabilities and shown routing/import/call relationships; unsampled reader-to-API and provider details are left out where the excerpts do not establish wiring.
Main entry points: api.php Application API · Embedder.php Text embeddings · Database.php Database access · index.php Web router
Components 18
Reader and web app
- Reading interface
templates/reader.php - Reader interactions
public/js/app.js - Web router
public/index.php - Authentication page
templates/auth.php - Application API
public/api.php
Book knowledge
- Book retrieval
src/BookService.php - Text embeddings
src/Embedder.php - Database access
src/Database.php - Neon Postgres
Grounded AI
- Grounded AI service
src/AIService.php - AI model providers
Admin and integrations
- Admin console
templates/admin.php - CLI ingestion
bin/ingest.php - MCP HTTP endpoint
public/mcp.php - MCP service
src/MCPService.php
Other components
- MCP clients
- Reader
- Administrator
Connections 26
- Reader → Web router: opens app
public/index.php - Web router → Authentication page: renders login
public/index.php - Web router → Reading interface: renders reader
public/index.php - Web router → Application API: routes API
public/index.php - Web router → MCP HTTP endpoint: routes MCP
public/index.php - Authentication page → Application API: authenticates via
templates/auth.php - Administrator → Admin console: manages books
README.md - Admin console → Database access: reads database
templates/admin.php - Admin console → Text embeddings: shows embedding status
- Application API → Book retrieval: retrieves passages
public/api.php - Application API → Grounded AI service: requests answers
public/api.php - Application API → Text embeddings: embeds content
public/api.php - Application API → Database access: accesses database
public/api.php - Book retrieval → Text embeddings: embeds queries
src/BookService.php - Book retrieval → Database access: queries chunks
src/BookService.php - Text embeddings → AI model providers: requests vectors
src/Embedder.php - Database access → Neon Postgres: connects to
src/Database.php - Grounded AI service → AI model providers: generates responses
src/AIService.php - CLI ingestion → Text embeddings: embeds chunks
bin/ingest.php - CLI ingestion → Database access: stores books
bin/ingest.php - MCP clients → MCP HTTP endpoint: sends JSON-RPC
README.md - MCP HTTP endpoint → MCP service: dispatches requests
public/mcp.php - MCP service → Book retrieval: uses retrieval
src/MCPService.php - MCP service → Grounded AI service: uses grounded AI
src/MCPService.php - MCP service → Text embeddings: backfills vectors
src/MCPService.php - MCP service → Database access: accesses database
src/MCPService.php