System Architecture
Tech Stack
The Inquiry Institute is built on a foundation of modern, open-source technologies— chosen not for novelty, but for their capacity to serve inquiry.
Architectural Principles
Decentralized by Design
Services are distributed across providers to avoid single points of failure. Identity via Supabase and Matrix; chat through Matrix; governance through OpenCollective.
Edge-First Compute
Over 30 Supabase Edge Functions handle faculty agents, webhooks, and real-time operations—executing close to users for minimal latency.
Semantic Web Ready
The Institute ontology is encoded in OWL and TTL, enabling machine-readable knowledge about faculty, courses, and organizational structure.
AI-Native Experience
Faculty agents are not chatbots—they are embodied personas with distinct voices, trained on specific corpora, interacting through multiple modalities.
Frontend
The face of the Institute—crafted for clarity and delight
Next.js 15↗
CoreReact framework with App Router for server-side rendering and static generation
Declarative UI library with concurrent features
Type-safe JavaScript for robust, maintainable code
Utility-first CSS framework for rapid styling
Production-ready motion library for React animations
Beautiful, consistent icon set
EB Garamond & Cinzel
FontsTypography befitting an institute of inquiry
Backend & Database
The foundation—storing knowledge, serving truth
Supabase↗
CorePostgreSQL database with real-time subscriptions, Auth, and Edge Functions
Edge Functions (Deno)
30+30+ serverless functions for faculty agents, chat, webhooks, and more
Row Level Security
Fine-grained database access control for multi-tenant security
pgvector
Vector similarity search for RAG and semantic queries
Cloud Infrastructure
Distributed across providers for resilience
Fly.io↗
PrimaryEdge-first container platform for Matrix chat server and WorkAdventure campus
RunPod↗
GPUServerless GPU compute for AI inference and LivePortrait animation
Cloud Functions, Cloud Storage, and compute resources
Route 53 DNS and S3 storage for assets
Infrastructure as Code for reproducible deployments
Docker
Containerization for Matrix, WorkAdventure, and other services
Static hosting for the main site with CI/CD
AI & Language Models
The minds behind the Faculty agents
LangChain↗
CoreFramework for building LLM-powered applications and RAG pipelines
LLM gateway for routing to multiple model providers
OpenAI Embeddings
Text embeddings for semantic search and similarity
AI avatar generation for Faculty video presence
Voice synthesis for Faculty speech
AI model hosting for image generation and processing
Voice & TTS
Giving voice to the Faculty—300+ neural voices
Microsoft Edge TTS
FREE300+ high-quality neural voices across 40+ languages, completely free
edge-tts-universal
Node.js library for Edge TTS integration
Faculty Voice Registry
100+100+ faculty members mapped to culturally-appropriate voices
Web Speech API
Browser-native fallback for instant voice preview
Audio Processing
Rate, pitch, and volume adjustments per faculty persona
Communication & Chat
The agora where dialogue unfolds
Matrix (Synapse)↗
PrimaryDecentralized chat protocol for Faculty Club and symposia, hosted on Fly.io
Matrix client embedded for real-time conversations
ChatUI
React chat components for AI interactions
WebSocket Service
Real-time presence and state synchronization
Identity & Authentication
Knowing who inquires
Supabase Auth
PrimaryUser authentication with social providers and magic links
Matrix Synapse
Chat and bot accounts (password auth, Application Service for faculty bots)
OIDC / JWT
Token-based authentication for API and integrations
Payments & Governance
Transparent stewardship of resources
Stripe↗
PrimaryPayment processing for memberships and patronage
Transparent budget and DAO governance
Webhook Integrations
Real-time payment and membership events
Knowledge & Semantics
Structured knowledge for machines and minds
Linked data processing for TTL and OWL ontologies
OWL Ontology
Formal knowledge representation of the Institute
TTL Knowledge Graphs
Faculty, courses, inquisitors as semantic triples
Vector RAG
Retrieval-augmented generation from corpora
Publishing & Media
Disseminating inquiry to the world
The Inquirer
JournalQuarterly journal with Faculty-authored articles and peer review
Editorial Workflow
Multi-stage peer review: draft → review → author response → revision
Print-on-demand for physical publications
Sharp
High-performance image processing and optimization
Markdown-based presentations for manifesto
Marked
Markdown parsing for dynamic content
DevOps & Quality
Maintaining rigor in code as in thought
End-to-end testing and mobile responsiveness
ESLint
Code linting and style enforcement
GitHub Actions
CI/CD pipelines for automated deployment
Google Analytics
Usage insights with privacy-conscious tracking
Transactional email for newsletters and notifications
Edge Functions Ecosystem
The Institute runs 30+ Supabase Edge Functions, each a specialized service:
facultyAgent responses
ask-facultyQ&A routing
villa-diodati-chatChat experience
inquireGeneral inquiry
llm-gatewayModel routing
matrix-webhookChat events
matrix-pollVoting
social-media-postPublishing
email-listNewsletter
patronage-supportersFunding
issue-microcredentialBadges
inquirer-generateArticle AI
All technologies chosen to serve the mission: fostering inquiry.
Social & Distribution
Spreading inquiry across platforms
Social Media Edge Function
AutoAutomated posting to multiple platforms from edge functions
X/Twitter Integration
Faculty announcements and article sharing
LinkedIn Publishing
Professional network distribution
RSS/Atom Feeds
Syndication feeds for The Inquirer journal articles
Open Graph
Rich link previews for all pages and articles
Google Analytics
Privacy-conscious tracking with cookie consent