README
¶
LeapView
LeapView is an open-source, agent-native BI platform. Build governed semantic models and dashboards as code, review every change in Git, and explore the same trusted analytics through interactive dashboards and AI agents.
Why LeapView?
- Analytics as code: define models, metrics, dashboards, and access rules as version-controlled resources.
- One governed layer: dashboards and agents use the same metrics, permissions, and data.
- Self-hosted: run the Go application on your own infrastructure with DuckDB and DuckLake execution.
- Built for existing data stacks: connect databases, object storage, and open lakehouse formats without moving dashboard definitions out of Git.
Try LeapView
The evaluation image is the quickest way to explore LeapView. It requires only Docker—no source checkout—and includes a disposable sample workspace.
docker pull ghcr.io/flidai/leapview:latest
docker run --detach --name leapview-evaluate --init \
--publish 127.0.0.1:8080:8080 \
--volume leapview-evaluate:/var/lib/leapview \
ghcr.io/flidai/leapview:latest evaluate
docker exec leapview-evaluate leapview evaluate first-login
Open http://localhost:8080, sign in with the one-time credentials, and choose Five-minute Sales Evaluation. The named volume preserves the evaluation across container restarts.
Evaluation mode is not a production configuration. Follow the installation guide to clean up the evaluation, work from source, or prepare a durable instance.
To remove the evaluation, run docker rm --force leapview-evaluate. Also run
docker volume rm leapview-evaluate when you want to delete its persisted data.
Documentation
- Documentation
- Getting started
- Build dashboards
- Self-hosting
- Architecture
- CLI, API, configuration, and resource reference
The repository also contains a release-oriented Docker Compose package for self-hosted deployments.
Development
Start the worktree-local development server:
task dev
Use task dev:status, task dev:logs, and task dev:stop to manage it. Run
task ci before handing off substantial changes.
See the repository and development workflow for prerequisites, generation rules, architecture boundaries, and the full contribution process.
Project status
LeapView is under active development. Follow GitHub releases for published versions and use the issue tracker for bugs and feature proposals.
License
LeapView is available under the MIT License.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
leapview
command
|
|
|
leapview-site
command
|
|
|
leapviewctl
command
|
|
|
Package docs owns authored and generated Markdown for the public documentation site.
|
Package docs owns authored and generated Markdown for the public documentation site. |
|
internal
|
|
|
access/api
Package api defines access-owned HTTP wire contracts.
|
Package api defines access-owned HTTP wire contracts. |
|
access/snapshot
Package snapshot defines the immutable access-policy projection installed when a serving state is activated.
|
Package snapshot defines the immutable access-policy projection installed when a serving state is activated. |
|
admin/cli
Package cli owns command-line adapters for offline Admin operations.
|
Package cli owns command-line adapters for offline Admin operations. |
|
admin/offline
Package offline owns offline administrative use cases and the ports they require from application composition.
|
Package offline owns offline administrative use cases and the ports they require from application composition. |
|
agent/cli
Package cli owns the Agent capability's command behavior.
|
Package cli owns the Agent capability's command behavior. |
|
agent/contracts
Code generated by apigen data-contract Go emitter.
|
Code generated by apigen data-contract Go emitter. |
|
agent/contracts/generate
command
Command generate emits provider-portable, dereferenced JSON Schemas for the model-facing contracts owned by the agent capability.
|
Command generate emits provider-portable, dereferenced JSON Schemas for the model-facing contracts owned by the agent capability. |
|
agent/productdocs
Package productdocs provides the agent capability with bounded search and read access to LeapView's generated, embedded documentation catalog.
|
Package productdocs provides the agent capability with bounded search and read access to LeapView's generated, embedded documentation catalog. |
|
analytics/arrowresult
Package arrowresult owns immutable, reference-counted analytical results.
|
Package arrowresult owns immutable, reference-counted analytical results. |
|
analytics/materialization
Package materialization exposes the narrow analytical execution port used by control-plane capabilities without exposing DuckDB lifecycle internals.
|
Package materialization exposes the narrow analytical execution port used by control-plane capabilities without exposing DuckDB lifecycle internals. |
|
analytics/resultcache
Package resultcache owns node-wide retention and coalescing for governed analytical query results.
|
Package resultcache owns node-wide retention and coalescing for governed analytical query results. |
|
analytics/runtime
Package runtime defines typed analytical contracts shared with consumer-owned adapters.
|
Package runtime defines typed analytical contracts shared with consumer-owned adapters. |
|
app/adminoffline
Package adminoffline composes Admin-owned offline use cases from concrete capability adapters, platform mechanisms, and process configuration.
|
Package adminoffline composes Admin-owned offline use cases from concrete capability adapters, platform mechanisms, and process configuration. |
|
app/api
Package api owns global public-API dispatch and generated wire contracts.
|
Package api owns global public-API dispatch and generated wire contracts. |
|
app/brand
Package brand owns the user-facing LeapView product identity.
|
Package brand owns the user-facing LeapView product identity. |
|
app/config/spec
Package configspec defines LeapView's application-wide environment contract.
|
Package configspec defines LeapView's application-wide environment contract. |
|
app/site/http
Package http serves the public LeapView website and documentation portal.
|
Package http serves the public LeapView website and documentation portal. |
|
app/site/search/sqlite
Package docsearch builds and queries the documentation site's immutable FTS5 index.
|
Package docsearch builds and queries the documentation site's immutable FTS5 index. |
|
app/site/visualdocs
Package visualdocs defines the generated contract shared by the visual documentation generator and the static documentation site.
|
Package visualdocs defines the generated contract shared by the visual documentation generator and the static documentation site. |
|
app/tools/agenttooldocgen
command
Command agenttooldocgen renders the canonical runtime agent tool catalog into public machine-readable and Markdown reference documentation.
|
Command agenttooldocgen renders the canonical runtime agent tool catalog into public machine-readable and Markdown reference documentation. |
|
app/tools/bootstrapmovielens
command
|
|
|
app/tools/bootstrapolist
command
|
|
|
app/tools/ciplan
command
|
|
|
app/tools/cireport
command
|
|
|
app/tools/clidocgen
command
Command clidocgen renders the Cobra command tree into public Markdown docs.
|
Command clidocgen renders the Cobra command tree into public Markdown docs. |
|
app/tools/configgen
command
|
|
|
app/tools/docsitegen
command
Command docsitegen composes authored navigation with generated reference catalogs into the runtime catalog and FTS5 search index used by the public site.
|
Command docsitegen composes authored navigation with generated reference catalogs into the runtime catalog and FTS5 search index used by the public site. |
|
app/tools/geometrygen
command
Command geometrygen vendors the pinned, authoritative geometry used by first-party geographic visualizations and their offline basemap.
|
Command geometrygen vendors the pinned, authoritative geometry used by first-party geographic visualizations and their offline basemap. |
|
app/tools/mapassets
command
|
|
|
app/tools/openapidocgen
command
Command openapidocgen turns the generated LeapView OpenAPI contract into the Markdown sources consumed by the public documentation site.
|
Command openapidocgen turns the generated LeapView OpenAPI contract into the Markdown sources consumed by the public documentation site. |
|
app/tools/schemadocgen
command
Command schemadocgen turns LeapView's JSON Schema contracts into the Markdown configuration reference consumed by the public documentation site.
|
Command schemadocgen turns LeapView's JSON Schema contracts into the Markdown configuration reference consumed by the public documentation site. |
|
app/tools/signalcontracts
command
|
|
|
app/tools/testshard
command
|
|
|
app/tools/toonjson
command
Command toonjson converts one TOON document on stdin to JSON on stdout for application-level agent contract checks.
|
Command toonjson converts one TOON document on stdin to JSON on stdout for application-level agent contract checks. |
|
app/tools/visualdocgen
command
Command visualdocgen compiles executable visual examples embedded in the public Markdown documentation into deterministic browser payloads.
|
Command visualdocgen compiles executable visual examples embedded in the public Markdown documentation into deterministic browser payloads. |
|
dashboard/analyticsruntime
Package analyticsruntime adapts the analytics capability's governed workspace runtime to dashboard-owned data interfaces.
|
Package analyticsruntime adapts the analytics capability's governed workspace runtime to dashboard-owned data interfaces. |
|
dashboard/catalog
Package catalog defines the neutral read model shared by workspace, dashboard, agent, admin, and UI transports.
|
Package catalog defines the neutral read model shared by workspace, dashboard, agent, admin, and UI transports. |
|
dashboard/cli
Package cli owns command-line adapters for the Dashboard capability.
|
Package cli owns command-line adapters for the Dashboard capability. |
|
dashboard/definition
Package definition owns immutable compiler-produced dashboard serving state.
|
Package definition owns immutable compiler-produced dashboard serving state. |
|
dashboard/publication
Package publication owns anonymous dashboard publication lifecycle state.
|
Package publication owns anonymous dashboard publication lifecycle state. |
|
dashboard/session
Package session owns dashboard-view state independently from page routes.
|
Package session owns dashboard-view state independently from page routes. |
|
dashboard/ui/signals
Package signals owns dashboard browser contract projections.
|
Package signals owns dashboard browser contract projections. |
|
dashboard/visualization/definition
Package definition owns immutable, compiler-produced visualization definitions.
|
Package definition owns immutable, compiler-produced visualization definitions. |
|
dashboard/visualization/format
Package format implements deterministic visualization formatting shared by browser-independent renderers and exports.
|
Package format implements deterministic visualization formatting shared by browser-independent renderers and exports. |
|
dashboard/visualization/geometry
Package geometry owns the immutable, content-addressed geographic assets available to compiled visualization specifications.
|
Package geometry owns the immutable, content-addressed geographic assets available to compiled visualization specifications. |
|
dashboard/visualization/ir
Code generated by apigen data-contract Go emitter.
|
Code generated by apigen data-contract Go emitter. |
|
dashboard/visualization/mapasset
Package mapasset owns the immutable, content-addressed cartographic style packages available to compiled visualization specifications.
|
Package mapasset owns the immutable, content-addressed cartographic style packages available to compiled visualization specifications. |
|
dashboard/visualization/mapasset/http
Package mapassethttp serves the immutable cartographic inventory through an HTTP transport without moving transport dependencies into the domain.
|
Package mapassethttp serves the immutable cartographic inventory through an HTTP transport without moving transport dependencies into the domain. |
|
dashboard/visualization/runtime
Package runtime shapes governed query results into the visualization IR.
|
Package runtime shapes governed query results into the visualization IR. |
|
deployment
Package deployment coordinates project-scoped atomic serving-state cutovers.
|
Package deployment coordinates project-scoped atomic serving-state cutovers. |
|
deployment/apiadapter
Package apiadapter translates public project deployment requests to the deployment domain.
|
Package apiadapter translates public project deployment requests to the deployment domain. |
|
deployment/http
Package http exposes project-scoped deployment operations over the generated API.
|
Package http exposes project-scoped deployment operations over the generated API. |
|
deployment/sqlite
Package sqlite persists project-scoped atomic deployments.
|
Package sqlite persists project-scoped atomic deployments. |
|
manageddata
Package manageddata defines immutable, project-global managed dataset revisions.
|
Package manageddata defines immutable, project-global managed dataset revisions. |
|
manageddata/apiadapter
Package apiadapter maps managed-data metadata to transport-neutral control contracts.
|
Package apiadapter maps managed-data metadata to transport-neutral control contracts. |
|
manageddata/binding
Package binding pins project-global managed-data revisions to serving states.
|
Package binding pins project-global managed-data revisions to serving states. |
|
manageddata/control
Package control coordinates backend-neutral managed-data upload sessions and revisions.
|
Package control coordinates backend-neutral managed-data upload sessions and revisions. |
|
manageddata/http
Package http exposes managed-data control operations over the generated API.
|
Package http exposes managed-data control operations over the generated API. |
|
manageddata/localplan
Package localplan discovers and hashes local files for managed data revisions.
|
Package localplan discovers and hashes local files for managed data revisions. |
|
manageddata/maintenance
Package maintenance provides conservative managed-data capacity and garbage collection services.
|
Package maintenance provides conservative managed-data capacity and garbage collection services. |
|
manageddata/maintenance/sqlite
Package sqlite implements managed-data reachability over the platform SQLite database.
|
Package sqlite implements managed-data reachability over the platform SQLite database. |
|
manageddata/resolver
Package resolver reconstructs persisted managed-data revisions for serving runtimes.
|
Package resolver reconstructs persisted managed-data revisions for serving runtimes. |
|
manageddata/runtimebinding
Package runtimebinding validates and applies trusted managed-data runtime roots through a consumer-owned binding target.
|
Package runtimebinding validates and applies trusted managed-data runtime roots through a consumer-owned binding target. |
|
manageddata/runtimeview
Package runtimeview materializes managed-data manifests as immutable local trees.
|
Package runtimeview materializes managed-data manifests as immutable local trees. |
|
manageddata/s3multipart
Package s3multipart coordinates durable S3 multipart uploads for managed data.
|
Package s3multipart coordinates durable S3 multipart uploads for managed data. |
|
manageddata/storage
Package storage defines managed-data blob persistence contracts.
|
Package storage defines managed-data blob persistence contracts. |
|
manageddata/storage/filesystem
Package filesystem implements private, content-addressed managed-data storage.
|
Package filesystem implements private, content-addressed managed-data storage. |
|
manageddata/storage/s3
Package s3 implements content-addressed managed-data storage on Amazon S3.
|
Package s3 implements content-addressed managed-data storage on Amazon S3. |
|
manageddata/storage/storagetest
Package storagetest provides backend conformance tests for managed-data storage.
|
Package storagetest provides backend conformance tests for managed-data storage. |
|
manageddata/storage/tus
Package tus adapts tusd's filesystem engine to managed-data upload contracts.
|
Package tus adapts tusd's filesystem engine to managed-data upload contracts. |
|
platform/buildinfo
Package buildinfo exposes the immutable identity of the running LeapView binary.
|
Package buildinfo exposes the immutable identity of the running LeapView binary. |
|
platform/cliapi
Package cliapi defines capability-agnostic facilities used by CLI adapters to call the application's generated HTTP API.
|
Package cliapi defines capability-agnostic facilities used by CLI adapters to call the application's generated HTTP API. |
|
platform/digest
Package digest validates canonical content identities shared by platform protocols.
|
Package digest validates canonical content identities shared by platform protocols. |
|
platform/http/cursorsigning
Package cursorsigning owns the process-wide key ring used by public API cursors.
|
Package cursorsigning owns the process-wide key ring used by public API cursors. |
|
platform/http/cursorsigning/sqlite
Package sqlite loads the cursor signing key ring from durable instance state.
|
Package sqlite loads the cursor signing key ring from durable instance state. |
|
platform/http/idempotency/sqlite
Package sqlite persists public API idempotency records and execution leases.
|
Package sqlite persists public API idempotency records and execution leases. |
|
platform/http/transport
Package transport contains capability-neutral HTTP protocol mechanics.
|
Package transport contains capability-neutral HTTP protocol mechanics. |
|
platform/jobs
Package jobs defines durable, leased background work shared by public API resources.
|
Package jobs defines durable, leased background work shared by public API resources. |
|
platform/jobs/http
Package http owns the HTTP representation of durable job events.
|
Package http owns the HTTP representation of durable job events. |
|
platform/jobs/module
Package module owns durable job persistence and runner lifecycle.
|
Package module owns durable job persistence and runner lifecycle. |
|
platform/transaction
Package transaction defines the minimal SQL transaction contract used by cross-capability atomic workflows without exposing concrete SQL handles.
|
Package transaction defines the minimal SQL transaction contract used by cross-capability atomic workflows without exposing concrete SQL handles. |
|
platform/web/transport
Package transport owns shared UI and pagestream HTTP transport mechanics.
|
Package transport owns shared UI and pagestream HTTP transport mechanics. |
|
project/artifact
Package artifact owns immutable, versioned project compiler output.
|
Package artifact owns immutable, versioned project compiler output. |
|
project/cli
Package cli owns command-line adapters for the Project capability.
|
Package cli owns command-line adapters for the Project capability. |
|
project/docvalidation
Package docvalidation validates executable examples embedded in Markdown.
|
Package docvalidation validates executable examples embedded in Markdown. |
|
project/manifest
Package manifest owns the compiler's mutable assembly model.
|
Package manifest owns the compiler's mutable assembly model. |
|
refresh/artifact
Package artifact defines the immutable project projection consumed by the refresh capability.
|
Package artifact defines the immutable project projection consumed by the refresh capability. |
|
refresh/module
Package module owns refresh transport and worker lifecycle composition.
|
Package module owns refresh transport and worker lifecycle composition. |
|
refresh/plan
Package plan turns compiled refresh definitions into deterministic execution plans.
|
Package plan turns compiled refresh definitions into deterministic execution plans. |
|
refresh/run
Package run owns the durable refresh lifecycle and its public contracts.
|
Package run owns the durable refresh lifecycle and its public contracts. |
|
release
Package release models immutable, project-wide deployment releases.
|
Package release models immutable, project-wide deployment releases. |
|
release/sqlite
Package sqlite persists API releases in the platform SQLite database.
|
Package sqlite persists API releases in the platform SQLite database. |
|
servingstate/module
Package module owns construction of serving-state persistence and exposes capability contracts without leaking its SQLite adapter.
|
Package module owns construction of serving-state persistence and exposes capability contracts without leaking its SQLite adapter. |
|
servingstate/validation
Package validation defines the narrow immutable asset-graph envelope stored and checked at serving-state boundaries.
|
Package validation defines the narrow immutable asset-graph envelope stored and checked at serving-state boundaries. |
|
workload
Package workload owns node-local workload admission, fairness, deadlines, and admission telemetry.
|
Package workload owns node-local workload admission, fairness, deadlines, and admission telemetry. |
|
workload/module
Package module owns process composition for node-local workload admission.
|
Package module owns process composition for node-local workload admission. |
|
workspace/cli
Package cli owns command-line adapters for the Workspace capability.
|
Package cli owns command-line adapters for the Workspace capability. |
|
workspace/navigation
Package navigation defines the workspace-owned read projection used to render application navigation.
|
Package navigation defines the workspace-owned read projection used to render application navigation. |
|
workspace/search
Package search owns LeapView's credential-scoped global catalog search.
|
Package search owns LeapView's credential-scoped global catalog search. |
|
pkg
|
|
|
agent
Package agent provides a small embedded agent harness for Go applications.
|
Package agent provides a small embedded agent harness for Go applications. |
|
pagestream
Package pagestream provides a small framework for Gomponents-rendered MPA pages that open one long-lived Datastar SSE transport.
|
Package pagestream provides a small framework for Gomponents-rendered MPA pages that open one long-lived Datastar SSE transport. |
|
Package siteassets owns the browser assets for the public LeapView site.
|
Package siteassets owns the browser assets for the public LeapView site. |
Click to show internal directories.
Click to hide internal directories.