How rilldata/rill works
Rill is an agent-first BI product: users define data models and metrics, explore dashboards or ask questions, and can deploy projects to Rill Cloud. The principal workflow runs from project files through parsing and resource reconciliation, connectors and OLAP execution, then query APIs to dashboards or agents. Separate branches cover the CLI/local developer experience and cloud administration, deployment, billing, alerts, and reports. README statements establish several product capabilities; source excerpts and the SOURCE INDEX support only the implementation links shown, so uncertain internal connections are omitted or marked unverified.
Main entry points: server/server.go Runtime API server · admin Admin services · controller.go Resource controller · server/server.go Cloud admin API
Components 25
Author and deploy
- Rill CLI
cli/cmd/root.go - Local server
cli/pkg/local/server.go
Project runtime
- Resource controller
runtime/controller.go - Project parser
runtime/parser - Project reconciler
runtime/reconcilers - Metrics semantics
runtime/metricsview/query.go - Query execution
runtime/query.go - OLAP and connectors
runtime/drivers - Project storage
runtime/storage/storage.go
Explore and query
- Runtime web client
web-common/src/runtime-client/v2/runtime-client.ts - Query helpers
web-common/src/runtime-client/v2/gen/query-service.ts - Runtime API server
runtime/server/server.go - Runtime resource API
runtime/server/controller.go - Conversational BI
runtime/ai - Dashboard experience
web-common/src/features/dashboards
Cloud services
- Cloud admin API
admin/server/server.go - Admin services
admin - Admin database
admin/database/database.go - Background jobs
admin/jobs/river - Deployment provisioning
admin/provisioner - Billing integrations
admin/billing
Other components
- Developer or analyst
- External AI agent
- OLAP engine
- Cloud user
Connections 27
- Developer or analyst → Rill CLI: authors and invokes
README.md - Rill CLI → Local server: starts locally
- Developer or analyst → Local server: starts project
README.md - Local server → Runtime API server: serves project runtime
- Runtime web client → Query helpers: uses query helpers
web-common/src/runtime-client/v2/runtime-client.ts - Query helpers → Runtime API server: sends query RPCs
- Runtime API server → Resource controller: uses runtime
runtime/server/server.go - Runtime resource API → Resource controller: reads and updates resources
runtime/server/controller.go - Resource controller → Project parser: waits for initial parse
runtime/controller.go - Resource controller → Project reconciler: coordinates reconciliation
- Project parser → Project reconciler: creates project resources
- Runtime API server → Metrics semantics: serves metrics capabilities
- Runtime API server → Conversational BI: hosts AI capabilities
runtime/server/server.go - Metrics semantics → Query execution: defines query model
- Query execution → OLAP and connectors: executes through connectors
- OLAP and connectors → OLAP engine: queries engine
- Resource controller → Project storage: uses project storage
- Developer or analyst → Dashboard experience: explores metrics
README.md - Dashboard experience → Runtime web client: requests runtime data
- External AI agent → Conversational BI: asks natural-language questions
README.md - Cloud user → Cloud admin API: uses cloud services
- Cloud admin API → Admin services: routes administration
admin/server/server.go - Admin services → Admin database: persists admin state
- Admin services → Background jobs: schedules background work
admin/jobs/river/biller_event_handlers.go - Admin services → Deployment provisioning: provisions deployments
- Admin services → Billing integrations: integrates billing
admin/jobs/river/biller_event_handlers.go - Cloud admin API → Runtime API server: supports cloud deployments