Skip to content

Installation

Prerequisites

Component Role Required
Rust toolchain Building from source Yes
protobuf-compiler Protobuf code generation Yes
NATS Message queue for agent communication Yes
Podman Container runtime for agents Yes
Ollama LLM inference and embedding No (but needed for agents that use LLMs) 
# Build tools
brew install protobuf
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Runtime dependencies
brew install nats-server
brew install podman

# Build tools
sudo apt install -y protobuf-compiler
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Runtime dependencies
curl -fsSL https://get.nats.io | sh
sudo apt install -y podman

# Build tools
sudo dnf install -y protobuf-compiler
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Runtime dependencies
curl -fsSL https://get.nats.io | sh
sudo dnf install -y podman

Build from Source

git clone https://github.com/vlindercli/vlindercli.git
cd vlindercli
cargo build --release
cp target/release/vlinder /usr/local/bin/vlinder

Bootstrap

Create the data directory and a minimal config:

mkdir -p ~/.vlinder/{agents,conversations,logs}

Create ~/.vlinder/config.toml:

[logging]
level = "info"

[ollama]
endpoint = "http://localhost:11434"

[queue]
backend = "nats"
nats_url = "nats://localhost:4222"

[state]
backend = "grpc"

Start Services

NATS

Start NATS with JetStream enabled:

# Create a minimal NATS config
cat > ~/.vlinder/nats.conf << 'EOF'
listen: 127.0.0.1:4222
jetstream {
  store_dir: ~/.vlinder/nats-data
}
EOF

nats-server -c ~/.vlinder/nats.conf -D &

nats-server -js -p 4222 &

Vlinder Daemon

vlinder daemon

Verify

vlinder agent list

Directory Structure

After setup, ~/.vlinder/ contains:

~/.vlinder/
├── config.toml         # Global configuration
├── nats.conf           # NATS config (JetStream enabled)
├── nats-data/          # NATS JetStream storage
├── agents/             # Agent data and storage
├── conversations/      # Conversations git projection
├── logs/               # JSONL log files
├── registry.db         # Registry database
└── dag.db              # DAG database

Next Steps