Installation

Build Kremis from source or run with Docker.

From Source

Requires Rust 1.89+ (stable, edition 2024).

git clone https://github.com/TyKolt/kremis.git
cd kremis
cargo build --release

The binaries are built to target/release/:

• kremis — CLI and HTTP server
• kremis-mcp — MCP server for AI assistants

Verify

cargo test --workspace
cargo clippy --all-targets --all-features -- -D warnings

Docker

docker build -t kremis .

# MCP server (default) — pipe MCP stdio JSON-RPC; suitable for any MCP client
docker run -i --rm kremis

# HTTP API only — override the entrypoint
docker run -d -p 8080:8080 -v kremis-data:/data \
  --entrypoint kremis kremis server -H 0.0.0.0 -D /data/kremis.db

Environment Variables

Variable	Description	Default
KREMIS_API_KEY	Enables Bearer token authentication	(disabled)
KREMIS_RATE_LIMIT	Requests per second rate limit	100
KREMIS_CORS_ORIGINS	Comma-separated allowed origins, or *	localhost only
KREMIS_LOG_FORMAT	Log output format: text or json	text
RUST_LOG	Log level filter (e.g. kremis=debug, info)	kremis=info,tower_http=debug
KREMIS_URL	Kremis server URL (used by the MCP bridge)	http://localhost:8080