hub / github.com/opensquilla/opensquilla

github.com/opensquilla/opensquilla @v0.4.1 sqlite

repository ↗ · DeepWiki ↗ · release v0.4.1 ↗

23,365 symbols 104,488 edges 1,755 files 3,840 documented · 16%

README

OpenSquilla

OpenSquilla is a Python agent runtime with MCP-native tools, durable sessions, local memory, multi-channel messaging, and a local web control UI.

The package is published as part of an OpenSquilla release zip. Install from the release bundle rather than from a source checkout so the wheel, dependency wheelhouse, install scripts, and third-party notices stay together.

Requirements

Python 3.12 or newer.
A configured model provider for live model calls.
Optional channel credentials only for the channel integrations you enable.

After Install

Run the onboarding command before starting the gateway:

opensquilla onboard --if-needed

Then start the local gateway:

opensquilla gateway run

Project Links

Repository, license, release, and third-party notice information are included in the release bundle and in the public OpenSquilla repository.

Extension points exported contracts — how you extend this code

ApprovalPushPayload (Interface)

* The `*.approval.requested|resolved` push payload (build_approval_event_payload). * A subset of the snapshot: it carri

opensquilla-webui/src/composables/chat/useChatApprovals.ts

GatewayState (Interface)

(no doc)

desktop/electron/src/main.ts

ShareStageProbe (Interface)

(no doc)

opensquilla-webui/e2e/share.spec.ts

SessionNavigationDiagStorage (Interface)

(no doc) [1 implementers]

opensquilla-webui/src/utils/chat/sessionNavigationDiag.ts

ProviderCatalogEntry (Interface)

(no doc)

desktop/electron/src/main.ts

SeedHistoryOptions (Interface)

(no doc)

opensquilla-webui/e2e/share.spec.ts

OpenSquillaDesktopApi (Interface)

(no doc)

opensquilla-webui/src/vite-env.d.ts

SearchProviderCatalogEntry (Interface)

(no doc)

desktop/electron/src/main.ts

Core symbols most depended-on inside this repo

append

called by 2560

src/opensquilla/cli/tui/backend/streaming.py

get

called by 2020

src/opensquilla/engine/usage.py

get

called by 1008

src/opensquilla/gateway/uploads.py

get

called by 895

src/opensquilla/skills/hub/taps.py

get

called by 655

src/opensquilla/cli/tui/backend/output_binding.py

get

called by 604

src/opensquilla/channels/manager.py

list

called by 539

src/opensquilla/gateway/static/js/views/skills.js

set

called by 485

src/opensquilla/gateway/static/js/theme.js

Shape

Function 16,157

Method 4,893

Class 1,932

Interface 290

Route 93

Languages

Python88%

TypeScript12%

Modules by API surface

src/opensquilla/gateway/static/js/views/chat.js455 symbols

tests/test_gateway/test_rpc_sessions.py248 symbols

tests/test_gateway/test_chat_view_static.py182 symbols

src/opensquilla/engine/runtime.py182 symbols

tests/test_cli/test_chat_cmd.py163 symbols

tests/test_skills/test_meta_mvp.py157 symbols

src/opensquilla/engine/agent.py148 symbols

tests/test_gateway/test_channel_dispatch_realtime.py115 symbols

src/opensquilla/memory/session_flush.py111 symbols

tests/test_engine/test_agent_llm_budget.py107 symbols

tests/test_gateway/test_router_boot.py106 symbols

src/opensquilla/gateway/static/js/views/setup.js106 symbols

Dependencies from manifests, versioned

@opentui/core0.3.0 · 1×

@playwright/test1.60.0 · 1×

@types/dompurify3.0.5 · 1×

@types/node25.9.1 · 1×

@vitejs/plugin-vue6.0.7 · 1×

dompurify3.4.11 · 1×

electron42.3.3 · 1×

electron-builder26.8.1 · 1×

happy-dom20.10.6 · 1×

highlight.js11.11.1 · 1×

html-to-image1.11.13 · 1×

katex0.17.0 · 1×

Datastores touched

dbDatabase · 1 repos

For agents

$ claude mcp add opensquilla \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact