Architecture Overview

January 12, 2026 · View on GitHub

Technical deep-dives into IntellyWeave's backend, frontend, and data flow.

What It Does

This section provides architectural documentation for developers who need to understand IntellyWeave's internal structure, extend functionality, or contribute to the codebase.

Architecture Documents

Document	Description
Backend Architecture	Python/FastAPI backend, Weaviate integration, agent system
Frontend Architecture	Next.js 15, React components, visualization libraries
Data Flow	Document processing pipeline, entity extraction, query flow
CLI	Operations CLI for database management, data migration, AI shell

High-Level Architecture

flowchart TB
    subgraph Frontend["Frontend (Next.js 15)"]
        Chat[Chat Interface]
        Mapbox[Mapbox Maps]
        VisNetwork[vis-network Graphs]
        CourthouseUI[Courthouse Debate UI]
    end

    subgraph Backend["Backend (FastAPI)"]
        DocUpload[Document Upload]
        AgentRouter[Agent Router]
        IntelOrch[Intelligence Orchestrator]
        GLiNER[GLiNER NER]
        CustomAgents[Custom Agents]
        Courthouse[Courthouse Debate]
    end

    subgraph Weaviate["Weaviate Vector DB"]
        Docs[Documents Collection]
        Chunks[Chunks Collection]
        EntityMeta[Entity Metadata]
    end

    Frontend <-->|REST API / WebSocket| Backend
    DocUpload --> GLiNER
    AgentRouter --> CustomAgents
    IntelOrch --> Courthouse
    GLiNER --> Weaviate
    Backend <--> Weaviate

Tech Stack Summary

Backend

Component	Technology	Purpose
Framework	FastAPI	REST API and WebSocket
Database	Weaviate	Vector storage and search
LLM Orchestration	DSPy	AI agent coordination
Entity Extraction	GLiNER	Named entity recognition
Multi-provider LLM	LiteLLM	OpenAI, Anthropic, etc.

Frontend

Component	Technology	Purpose
Framework	Next.js 15	React server components
UI Components	Radix UI	Accessible primitives
Styling	Tailwind CSS	Utility-first CSS
Maps	Mapbox GL 3.16	3D geospatial visualization
Graphs	vis-network	Relationship visualization
Animations	Framer Motion	UI transitions