How malvolt/voldt-api works
Voldt API is a modular Fastify REST API. Clients call domain endpoints; the app initializes request statistics and uses a route loader to discover and register route modules, which return endpoint results. The route tree covers AI, discovery, downloads, search, temporary mail, and utility services. The app also serves static pages and generated OpenAPI documentation. Sampled source confirms the routing, stats, and selected search and AI integrations; other route internals are represented by their directory, with no unsampled service calls inferred.
Main entry points: loadRoutes.ts Route loader · app.ts Fastify app · routes Search endpoints · stats.ts Request counters
Components 16
API runtime
- Fastify app
src/app.ts - Route loader
src/lib/loadRoutes.ts
AI services
- AI endpoints
src/routes
Content services
- Discovery endpoints
src/routes - Download endpoints
src/routes
Search and tools
- Search endpoints
src/routes - Temporary mail
src/routes - Utility endpoints
src/routes
Stats and web
- Request counters
src/stats.ts - Stats file
public/stats.json - Static pages
public - OpenAPI docs
src/app.ts
Other components
- API client
- NoteGPT service
- MyAnimeList
- Bing Search
Connections 15
- API client → Fastify app: sends requests
src/app.ts - Fastify app → Route loader: loads routes
src/app.ts - Route loader → AI endpoints: imports modules
src/lib/loadRoutes.ts - Route loader → Discovery endpoints: imports modules
src/lib/loadRoutes.ts - Route loader → Download endpoints: imports modules
src/lib/loadRoutes.ts - Route loader → Search endpoints: imports modules
src/lib/loadRoutes.ts - Route loader → Temporary mail: imports modules
src/lib/loadRoutes.ts - Route loader → Utility endpoints: imports modules
src/lib/loadRoutes.ts - Fastify app → Request counters: updates counters
src/app.ts - Request counters → Stats file: reads and writes
src/stats.ts - Fastify app → Static pages: serves pages
src/app.ts - Fastify app → OpenAPI docs: serves spec
src/app.ts - Search endpoints → MyAnimeList: queries details
src/routes/search-mal.ts - Search endpoints → Bing Search: fetches results
src/routes/search-bing.ts - AI endpoints → NoteGPT service: submits image jobs
src/routes/ai-img2img.ts