Build with the Vifu Agent Runtime

Vifu is a small, fast, stateful, and portable runtime for agents.

Connect applications to agents from local or remote providers through one runtime for stable APIs, durable state, access control, routing, and traces.

Choose where to start

The runtime stack

An application can host one project directly:

The service deployment operates many projects:

• VifuRuntime owns the providers, Agents, endpoints, sessions, state, and effects for one embedded application.
• Vifu Server owns project APIs, authorization, runtime sessions, and persistence across multiple projects.
• Vifu Agent Gateway is an optional Server transport that connects provider resources from another machine and reports the Agents they expose.
• PostgreSQL stores durable project and runtime data.
• Operations Console manages projects, Agents, providers, keys, connections, and traces.

Agent Gateway connects to a running Vifu Server. An embedded application registers provider implementations directly with VifuRuntime.

Start the local release

Download and extract the archive for your platform from the latest release, then run:

./vifu

Vifu creates its local Runtime profile and opens the live TUI. Press B to open the embedded Dashboard at the same Server address, normally http://127.0.0.1:6790. Confirm the Runtime independently:

curl --fail --silent http://127.0.0.1:6790/health

The Console guides project, provider, Agent, and key setup. Read Self-hosting before exposing the deployment on a network.

Call a project endpoint

Create a project key in the Console, then call an Agent through the OpenAI-compatible endpoint:

curl http://127.0.0.1:6790/my-project/v1/chat/completions \
  --header "Authorization: Bearer $VIFU_PROJECT_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "guide",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

The project endpoint remains stable while provider configuration changes. Provider credentials remain inside the Vifu deployment.

Read Core runtime design for the execution boundary and Dashboard architecture for hosted and self-hosted authority.

Related agent runtimes

These open-source projects solve adjacent parts of the agent runtime stack. The comparison describes each project's primary model, not an exhaustive feature checklist.

Vifu does not replace agent providers. It gives applications a stable, stateful runtime contract for accessing agents across local and remote providers.