System
Architecture
Seshat is built in eight clean layers — from the interface you're looking at right down to the edge runtime it lives on. Each layer does one job and hands off to the next. Here's the whole picture, top to bottom.
Data flow
Scheduled scans pull from providers, the agents turn raw data into scores and research, and the API surfaces it to the UI — all on the same edge.
Frontend
Web UIThe public face of Seshat — the live dashboard, the documentation, and the conversational chat interface. Everything you see here.
API Layer
Public read APIA clean, read-only interface that serves tokens, scores, fees, trending narratives, and developer intelligence to anything that wants to consume it.
Agents & Intelligence
The brainsThe scoring engine, the deep-research loop, the self-learning model, the outcome-labelling system, and the multi-persona swarm that gauges sentiment. This is where signal is separated from noise.
External Providers
Data sourcesIntegrations with on-chain and market data — the Base network, token-launch platforms, market and liquidity aggregators, and social signal feeds. The eyes and ears.
Orchestration & Queues
The pipelineScheduled scans wake the system on a cadence, and asynchronous work queues fan the heavy lifting out across the edge so nothing blocks and nothing is missed.
Shared Types & Utilities
Common contractsThe shared vocabulary of the system — the type definitions and helper utilities every layer agrees on, keeping the whole stack consistent and type-safe.
Data Layer
Stores & memoryWhere everything lives: structured relational records, a fast key-value cache, a vector index that powers semantic search, and durable storage for long-form research reports.
Project & Infrastructure
The foundationDeployment, configuration, and the globally-distributed edge runtime the whole system runs on — no servers to babysit, live close to every user.
Mapped with
Powered by Understand-Anything
This architecture view was distilled from a full knowledge graph of the codebase, built with Understand-Anything — an open tool that maps how a system actually fits together. The graph stays internal; this is the curated, public summary.