A Platform for Agents & Humans in The Loop https://docs.vski.ai
  • TypeScript 81.9%
  • Python 10.2%
  • Makefile 3.1%
  • Go 2.4%
  • JavaScript 2.3%
  • Other 0.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-16 06:48:49 +01:00
.bin v0.17.7 2026-11-08 21:40:48 +01:00
.release feat(dashboard): route every surface through widget mode 2026-11-15 18:25:08 +01:00
benchmarks v0.17.0 2026-11-06 18:48:39 +01:00
examples/plugins v0.15.2 2026-11-02 21:58:00 +01:00
integration feat(connectors): add connector modules and v0.18.0 notes 2026-11-15 05:21:22 +01:00
k8s@357ebc9104 v0.17.7 2026-11-08 21:40:48 +01:00
platform.wiki@4c5b53599e update submodules 2026-11-16 06:48:49 +01:00
py-sdk@6058e10191 update submodules 2026-11-15 18:49:16 +01:00
tango@0209dc2754 v0.17.7 2026-11-08 21:40:48 +01:00
ts-sdk@04ba5f97ca update submodules 2026-11-15 18:49:16 +01:00
vski@ea7864a5a5 feat(dashboard): agent-facing widgets, connect handoff, signal approvals 2026-11-15 17:08:02 +01:00
web@dac7f10460 update submodules 2026-11-16 06:48:49 +01:00
.env.example refactor: change domain references 2026-03-02 18:33:30 +01:00
.gitignore reactor 2026-11-04 16:27:39 +01:00
.gitmodules add tango and k8s submodules 2026-11-08 05:11:23 +01:00
LICENSE chore: readme 2026-02-15 14:36:37 +01:00
README.md feat(connectors): add connector modules and v0.18.0 notes 2026-11-15 05:21:22 +01:00

VSKI

Vector-Semantic Knowledge Index

VSKI is a high-performance, lightweight backend engine designed for modern applications requiring real-time synchronization and complex distributed workflows. It provides a multi-tenant environment using SQLite3 with a focus on simplicity, scalability, and security.

VSKI can easily replace PostgreSQL or other traditional RDBMS for most backend-related tasks. It provides a server layer on top of SQLite3 ensuring access control, proper concurrent access, ACID, and high-throughput database I/O.

Features

  • Multi-Tenant SQLite: automatic management of multiple isolated database files
  • Dynamic Schema: flexible collection-based data management with runtime schema enforcement and reviewable migrations
  • Declarative IaC: collections, pipelines, cron, webhooks, secrets, plugin instances, graphs and connectors as versioned YAML (vski plan / apply / pull), plus idempotent seed files (vski seed)
  • Distributed Workflows: persistent, stateful workflow orchestration with WebSocket-based workers
  • Pipelines: declarative JSON DAGs (plugin calls, HTTP requests, timers, approval gates, LLM steps) executed durably by the engine
  • Light Graphs: labeled nodes and weighted edges with in-memory traversals in the same per-tenant SQLite file
  • Real-time Engine: integrated WebSocket gateway for instantaneous data broadcasting via pub/sub architecture
  • Rule-based Security: granular access control using a custom rule engine that synthesizes SQL WHERE clauses, down to per-field rules
  • Embedded Search: first-class support for Full-Text Search (FTS5) and Vector similarity search (sqlite-vec)
  • Plugins: supervised Python extensions (JSON-RPC over stdio) with config, lifecycle, logs and invocation
  • Replication: master/replica file sync for read scaling
  • Standalone Binary: single binary with embedded web frontend, no separate frontend server needed
  • Docker Support: official images (API-only and standalone)

Quick Start

The quickest path is the vski command line (Python 3.11+ and Docker):

pip install "vski-sdk[cli]" --extra-index-url https://vski.sh/api/packages/x/pypi/simple/

vski install          # pulls vski.sh/x/vski:latest-standalone
vski serve            # runs it on http://127.0.0.1:3000
vski doctor           # verifies server, auth, docker, image

Open http://127.0.0.1:3000/installer to create the first admin, then:

vski login
vski init my-app      # bootstrap a project from the app template
cd my-app && make venv
make iac-plan && make iac-apply

From the template directly

git clone https://vski.sh/x/template.git vski-app
cd vski-app
make dev

Manual setup

# Standalone binary (server + embedded web UI)
wget https://vski.sh/x/platform/releases/download/latest/vski-standalone
chmod +x vski-standalone
./vski-standalone
# Docker: light (API only) or standalone (with web UI)
docker run -p 3000:3000 -v $(pwd)/data:/app/data vski.sh/x/vski:latest
docker run -p 3000:3000 -v $(pwd)/data:/app/data vski.sh/x/vski:latest-standalone

Documentation

  • Docs site: https://docs.vski.ai (generated from the wiki, which stays the source of truth)
  • Getting Started / Command Line / IaC: the wiki's Start section
  • API reference: OpenAPI spec served by the server at /openapi.json (browsable at /openapi.html), plus the docs in the embedded web UI

Repository layout

Path What it is
vski/ The server (Go, SQLite; API, workflows, pipelines, replication)
tango/ The cluster proxy: read/write splitting, write journal, failover with hot promotion
k8s/ The vski-cluster Helm chart (vski StatefulSet + tango + Redis)
web/ The web UI (React), embedded into the standalone binary
ts-sdk/ The TypeScript/JS SDK (@vski/sdk)
py-sdk/ The Python SDK (vski-sdk) and the vski CLI
examples/plugins/ Example Python plugins
emulator/ Playground (experimental)
docs/ Development notes and release notes

Multi-Tenancy

Reserved database names:

  • default.db - system metadata
  • stats.db - request statistics
  • workflows.db - workflow runs, events and queues (replicated as a passive copy; execution is master-only)

License

See vski/LICENSE for license information.