Skip to content

How to use Blablador with Pi agent

Helmholtz Blablador is not only the most useful and private Chat Robot out there. You can also connect it to Pi Agent, to get a powerful CLI AI assistant with access to Blablador's private models. Imagine a full-featured AI agent that runs entirely in your terminal, with private model access!

Pi Agent

Pi is a minimal terminal coding harness. Adapt Pi to your workflows, not the other way around. - from the Pi website.

It is a CLI-based AI agent that can:

  • Execute terminal commands
  • Read and write files
  • Browse the web
  • Manage memory and skills
  • Delegate tasks to subagents
  • And much more...

Prerequisites

Steps

1. Install Pi

Follow the installation instructions on the Pi Website. It's a one-liner copy-and-paste.

2. Configure Blablador Provider

Edit the ~/.pi/agent/models.json file to add Blablador as a provider. You can use the following template:

{
  "providers": {
    "blablador": {
      "baseUrl": "https://api.helmholtz-blablador.fz-juelich.de/v1",
      "api": "openai-completions",
      "apiKey": "YOUR_BLABLADOR_API_TOKEN",
      "models": [
        { "id": "alias-code" },
        { "id": "alias-huge" },
        { "id": "alias-fast" },
        { "id": "alias-large" }
      ]
    }
  }
}

3. Start Pi Agent

Run pi in your terminal to start the Pi Agent. Then use the /model command to select Blablador models for your tasks. You can also set Blablador as the default provider for specific tasks or globally.

Use packages to extend Pi's capabilities

Pi provides a rich package ecosystem to extend the capabilities of your agent.

Example:

You might find the pi-web-access package useful to enable web browsing capabilities for your Blablador-powered agent. Install it with:

pi install npm:pi-web-access