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
File locations
| Data | Default 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 |
Related pages
Last modified on May 8, 2026
