OpenSquilla

v1.0.0Coding Agentsstable

OpenSquilla — Token-Efficient AI Agent with same budget, higher intelligence density

agentaiai-agentsdeep-learningfoundation-models
Share:
1,341
Stars
0
Downloads
0
Weekly
0/5

What is OpenSquilla?

OpenSquilla is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to opensquilla — token-efficient ai agent with same budget, higher intelligence density

OpenSquilla — Token-Efficient AI Agent with same budget, higher intelligence density

This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • OpenSquilla — Token-Efficient AI Agent with same budget, hig

Use Cases

Token-efficient AI agent design
Higher intelligence density with same budget
opensquilla

Maintainer

LicenseApache-2.0
Languagepython
Versionv1.0.0
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx opensquilla

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use OpenSquilla

OpenSquilla is a token-efficient AI agent platform that uses an on-device LightGBM/ONNX routing model (SquillaRouter) to automatically assign each query to the most cost-effective LLM tier—routing simple tasks to fast cheap models and complex ones to frontier models—without sacrificing result quality. It exposes a full agentic toolkit including file operations, shell execution, web search, persistent memory via SQLite and ONNX embeddings, and 15 bundled skills covering coding, GitHub, document generation, and scheduling. Developers and teams deploy OpenSquilla to run autonomous agents across a Web UI, terminal REPL, and messaging channels like Slack, Telegram, and Feishu, all with three configurable sandbox security tiers.

Prerequisites

  • Python 3.12 and uv (for the recommended uv tool install path), or the Windows portable zip for Windows users
  • An API key for at least one LLM provider: OpenRouter (OPENROUTER_API_KEY), OpenAI (OPENAI_API_KEY), or Anthropic
  • Optional: a Brave Search API key (BRAVE_SEARCH_API_KEY) for web search capability
  • An MCP client if integrating as an MCP server, or use the built-in Web UI at http://127.0.0.1:18791
1

Install OpenSquilla with uv

The recommended installation uses uv tool install to create an isolated environment with all recommended extras. The onboard command then guides you through initial provider setup.

uv tool install --python 3.12 "opensquilla[recommended] @ https://github.com/opensquilla/opensquilla/releases/download/v0.3.1/opensquilla-0.3.1-py3-none-any.whl"
opensquilla onboard
2

Configure your LLM provider

Set your API key and preferred provider. For non-interactive environments such as CI or SSH servers, use environment variables directly.

export OPENROUTER_API_KEY="sk-or-your-key"
opensquilla onboard --provider openrouter --api-key-env OPENROUTER_API_KEY
3

Start the gateway

Run the gateway to start the Web UI at http://127.0.0.1:18791. From there you can chat with agents, manage skills, and monitor cost and token usage.

opensquilla gateway run
4

Run diagnostics

Use the doctor command to verify your provider keys, router model, and search integration are all configured correctly before starting real work.

opensquilla doctor
5

Configure optional web search

To enable web search in agents, set your Brave Search API key and reconfigure the search provider.

export BRAVE_SEARCH_API_KEY="your-brave-key"
opensquilla configure search --search-provider brave
6

Connect a messaging channel (optional)

Link Slack, Telegram, or another channel so agents can receive tasks and send results through your preferred messaging platform.

opensquilla channels status slack

OpenSquilla Examples

Client configuration

Claude Desktop MCP configuration pointing to the OpenSquilla gateway's MCP endpoint after the gateway is running.

{
  "mcpServers": {
    "opensquilla": {
      "command": "opensquilla",
      "args": ["gateway", "run"],
      "env": {
        "OPENROUTER_API_KEY": "sk-or-your-key",
        "BRAVE_SEARCH_API_KEY": "your-brave-key"
      }
    }
  }
}

Prompts to try

Example one-shot agent commands and interactive prompts for OpenSquilla.

- "Search the web for the top 5 open-source vector databases in 2025 and create a comparison table in a new file comparison.md."
- "Clone the GitHub repo at https://github.com/example/app, run the test suite, and send me a summary of failures."
- "Remember that my preferred code style is PEP 8 with 88-character line limits."
- "Schedule a daily agent run at 09:00 UTC that fetches the latest ArXiv AI papers and emails me a digest."
- "What did I work on yesterday? Check my MEMORY.md for recent session notes."

Troubleshooting OpenSquilla

uv tool install fails with Python version mismatch

OpenSquilla requires Python 3.12 exactly. Install it with 'uv python install 3.12' and then retry the tool install command with '--python 3.12'.

opensquilla doctor reports routing model not found

The SquillaRouter ONNX model is bundled in the recommended extras. If you installed with a minimal extras flag, reinstall with 'opensquilla[recommended]'. The onboard command will also re-download missing models.

Web UI at port 18791 is unreachable after 'gateway run'

Check that no other process is using port 18791 with 'lsof -i :18791'. On Windows, run 'Start OpenSquilla.cmd' as administrator if the portable install is used. Firewall rules on Linux may also block the local port.

Frequently Asked Questions about OpenSquilla

What is OpenSquilla?

OpenSquilla is a Model Context Protocol (MCP) server that opensquilla — token-efficient ai agent with same budget, higher intelligence density It connects AI assistants to external tools and data sources through a standardized interface.

How do I install OpenSquilla?

Follow the installation instructions on the OpenSquilla GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with OpenSquilla?

OpenSquilla works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is OpenSquilla free to use?

Yes, OpenSquilla is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

Browse More Coding Agents MCP Servers

Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "opensquilla": { "command": "npx", "args": ["-y", "opensquilla"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use OpenSquilla?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides