Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.oktolabs.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Local development

You can run Pulse from the two source repos in this workspace: okto-pulse-core for the engine and okto-pulse for the installable community package.

​
Prerequisites

Use Python 3.12 locally. The package metadata allows Python 3.11+, but CI and Docker use 3.12.

​
Install from source

Run this from the workspace root: 
pip install -e ./okto-pulse-core -e ./okto-pulse
pip install pytest pytest-asyncio psutil httpx ruff pyright build

Successfully installed okto-pulse okto-pulse-core

​
Initialize and serve

okto-pulse init --agents
okto-pulse serve --accept-terms

API/UI: http://127.0.0.1:8100
MCP:    http://127.0.0.1:8101/mcp

​
Running tests

For core work: 
cd okto-pulse-core
pytest -m "not e2e" -q
For community CLI/runtime work: 
cd okto-pulse
pytest -q

​
File locations

DataDefault path
SQLite DB~/.okto-pulse/data/pulse.db
Uploads~/.okto-pulse/uploads/{board_id}/
Board graph~/.okto-pulse/boards/{board_id}/graph.lbug
Global discovery graph~/.okto-pulse/global/discovery.lbug
Last modified on May 8, 2026