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.

Next.jsSupabaseFly.ioLangChainMatrixRunPodStripe+50 more

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

React 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

Fonts

Typography befitting an institute of inquiry

Backend & Database

The foundation—storing knowledge, serving truth

PostgreSQL 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

Primary

Edge-first container platform for Matrix chat server and WorkAdventure campus

Serverless 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

Framework 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

FREE

300+ 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

📡

Social & Distribution

Spreading inquiry across platforms

Social Media Edge Function

Auto

Automated 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

Communication & Chat

The agora where dialogue unfolds

Decentralized 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

Primary

User 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

Primary

Payment 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

Journal

Quarterly 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:

faculty

Agent responses

ask-faculty

Q&A routing

villa-diodati-chat

Chat experience

inquire

General inquiry

llm-gateway

Model routing

matrix-webhook

Chat events

matrix-poll

Voting

social-media-post

Publishing

email-list

Newsletter

patronage-supporters

Funding

issue-microcredential

Badges

inquirer-generate

Article AI

+18 more functions
12
Tech Categories
30+
Edge Functions
300+
TTS Voices
Questions Answered

All technologies chosen to serve the mission: fostering inquiry.