Filesystem context with OpenViking

This example demonstrates how to use OpenViking to manage an agent's context as a hierarchical filesystem.

OpenViking allows agents to organize knowledge, memory, and state into directories and files, using the viking:// protocol for navigation and retrieval.

The key features of this example include:

• Hierarchical context: Context is structured like a filesystem (e.g., viking://resources/, viking://session/).
• Tiered retrieval: Information is processed into three layers (L0: Abstract, L1: Overview, L2: Full Content) to optimize token usage.
• Filesystem operations: Agents can use familiar operations like ls, read, and find to interact with their context.

Prerequisites

• Python 3.9+
• OpenViking library

Steps for running this example

1. Install dependencies:

python -m venv .venv

# macOS/Linux:
source .venv/bin/activate

# Windows Command Prompt:
.venv\Scripts\activate.bat

# Windows PowerShell:
.venv\Scripts\Activate.ps1

pip install -r requirements.txt

2. Create OpenViking configuration :

openviking-server init

3. Run the script:

python openviking_example.py

Output

The script will execute a task that demonstrates how OpenViking manages the agent's context as a filesystem. The output will show the structure of the virtual filesystem, the retrieval of information at different tiers, and the results of filesystem operations.