Practical overview
When it fits
Use Spark when you want a coding agent to work against a project directory through a local browser interface, with configurable tool permissions and retained project context.
Who it is for
- Developers who want an AI agent to investigate and edit a local project repository.
- Teams or individuals who want to set tool permissions and approve agent actions.
- Developers who need project-aware guidance retained across sessions.
Documented uses
- Search project files and inspect code.
- Ask the agent to make file changes or perform shell and Jupyter tasks.
- Break a coding request into a multi-step plan and delegate subtasks to parallel sub-agents.
- Apply project conventions through AGENTS.md and persistent memory.
- Review earlier session states and roll back to a checkpoint.
Requirements & limits
The README documents a self-hosted setup, Python 3.11 or newer, and an OpenAI-compatible API or model backend. Node.js 18 or newer is required for frontend development only. The repository states that Spark is MIT-licensed.
- Spark's primary interface is a browser served locally after running its web command.
- Model connections use OpenAI-compatible APIs; named options include DeepSeek, OpenAI, Ollama, and Azure.
- The four-level sandbox, approval flow, and protected paths are relevant when deciding how much access to grant.
- MCP compatibility is stated, but the README does not document a particular server integration.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up Spark's browser interface for a project
Install Spark and start its web interface pointed at a project directory.
Before you start
- Python 3.11 or newer
- An OpenAI-compatible API or model backend, such as DeepSeek, OpenAI, Ollama, or Azure
- A project directory to use as the work directory
Steps
Clone the Spark repository and enter its directory.
Create and activate a Python virtual environment.
Install Spark with the command below.
pip install -e ".[dev]"Run
spark web --workdir /your/projectand openhttp://localhost:8000in a browser.
Expected outcome
A local browser interface for conversing with Spark about the selected project.
Guide limitations
- The README lists Node.js 18 or newer for frontend development only.
- Provider-specific model setup is not included in the README.
Compare options for AI coding assistance
These projects document a common task and share a project role. This is a source-based comparison, not an execution benchmark or a guarantee of interchangeability.
| Project | Documented purpose | Platform | Access and requirements |
|---|---|---|---|
| Spark | Search project files and inspect code. | CLI, Self-hosted, Server, Web | The README documents a self-hosted setup, Python 3.11 or newer, and an OpenAI-compatible API or model backend. Node.js 18 or newer is required for frontend development only. The repository states that Spark is MIT-licensed. |
| Llmcode | Inspect a project's directory structure with `/tree`. | CLI | The documented setup requires an API key and supports an API base URL and model setting. The project is open source under Apache-2.0. |
| Klaat Code | Open a project directory for terminal-based coding assistance. | CLI, Server | The README provides a global npm installation command and documents browser sign-in with a KlaatAI account. It also identifies the repository as open source under Apache 2.0. |
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 13 October 2026
- Original website title
- badhope/spark · Official homepage title · retained in its source language

