Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Quick Start

This guide will get you up and running with Vultrino in under 5 minutes.

1. Initialize Vultrino

First, initialize the configuration and set up your admin account:

vultrino init

You’ll be prompted to:

  1. Set a storage password (encrypts your credentials at rest)
  2. Create an admin username for the web UI
  3. Set an admin password for the web UI

Tip: Set the VULTRINO_PASSWORD environment variable to avoid password prompts:

export VULTRINO_PASSWORD="your-secure-password"

2. Add Your First Credential

Add an API key credential:

vultrino add --alias github-api --key ghp_your_github_token

Add a Basic Auth credential:

vultrino add --alias my-service --type basic_auth --username admin --password secret123

3. List Your Credentials

vultrino list

Output:

ALIAS                TYPE            ID                                   DESCRIPTION
github-api           api_key         a1b2c3d4-...                        -
my-service           basic_auth      e5f6g7h8-...                        -

4. Make an Authenticated Request

Use the request command to make API calls with your stored credentials:

vultrino request github-api https://api.github.com/user

The credential is automatically injected — you never need to expose the actual token.

5. Start the Web UI

Launch the admin dashboard:

vultrino web

Open http://127.0.0.1:7879 and log in with your admin credentials.

6. Use with AI Agents (MCP)

Start the MCP server for LLM integration:

vultrino serve --mcp

Configure your AI agent (Claude, etc.) to use Vultrino as an MCP server. See Using with AI Agents for detailed setup instructions.

Common Commands

CommandDescription
vultrino initInitialize configuration
vultrino addAdd a credential
vultrino listList all credentials
vultrino remove <alias>Remove a credential
vultrino request <alias> <url>Make authenticated request
vultrino webStart web UI
vultrino serve --mcpStart MCP server
vultrino role listList roles
vultrino key createCreate API key

Next Steps