OpenViking mit einem Klick auf Pethost deployen

Was passiert

1. Du meldest dich bei Pethost an oder legst ein Konto an, mit Passkey, GitHub oder Google.
2. Noch keine Maschine? Du wählst einen Tarif, und wir bereiten eine für dich vor. Der Link wartet in deinem Browser, bis sie bereit ist.
3. „Neues Projekt“ öffnet sich bei der App. Du füllst aus, was sie braucht, und klickst auf „Projekt erstellen“: OpenAI-API-Key.
4. In ein, zwei Minuten läuft die App unter eigener Adresse mit HTTPS. Ihre Secrets werden zufällig für sie erzeugt, und ihre Daten sind im nächtlichen Backup.
5. Sie ist ein Projekt wie jedes andere: compose.yaml, .env, Logs und ein Terminal findest du im Panel, und dein Agent kann sie ändern, zurückrollen oder wiederherstellen.

Erste Schritte

Öffne https://openviking.sam.pethost.app/studio/settings und füge den Root-Key ein: Er steht als OPENVIKING_ROOT_API_KEY in der .env des Projekts. Leg dann unter /studio/users einen Account und einen Nutzer an: Den Key des Nutzers verwenden die ov-CLI, die SDKs und Agenten. Embeddings und Zusammenfassungen gehen mit deinem Key an OpenAI. Daten und ov.conf bleiben in /app/.openviking erhalten.

Was läuft

Die Vorlage ist diese compose.yaml und die Variablen, die sie in die .env des Projekts schreibt. Pethost führt die Datei so aus, wie sie geschrieben ist.

services:
  openviking:
    image: ghcr.io/volcengine/openviking:v0.5.0
    restart: unless-stopped
    environment:
      OPENAI_API_KEY: ${OPENAI_API_KEY}
      OPENVIKING_ROOT_API_KEY: ${OPENVIKING_ROOT_API_KEY}
      OPENVIKING_PUBLIC_BASE_URL: ${URL}
      # The bot needs a user's key of its own; the server runs without it.
      OPENVIKING_WITH_BOT: "0"
      # Written to ov.conf in the volume at the first start only. The server
      # expands the ${...} in it at every start, so a key changed in .env
      # takes effect on a restart.
      OPENVIKING_CONF_CONTENT: |
        {
          "server": {
            "host": "0.0.0.0",
            "port": 1933,
            "root_api_key": "$${OPENVIKING_ROOT_API_KEY}"
          },
          "storage": {
            "workspace": "./data",
            "vectordb": { "name": "context", "backend": "local" },
            "agfs": { "backend": "local" }
          },
          "embedding": {
            "dense": {
              "provider": "openai",
              "api_key": "$${OPENAI_API_KEY}",
              "model": "text-embedding-3-small",
              "dimension": 1536
            }
          },
          "vlm": {
            "provider": "openai",
            "api_key": "$${OPENAI_API_KEY}",
            "model": "gpt-4o-mini"
          }
        }
    volumes:
      - data:/app/.openviking

volumes:
  data:

compose.yamlAuf GitHub ansehen