spark-agent 0.9.6__tar.gz

spark_agent-0.9.6/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 badhope
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

spark_agent-0.9.6/PKG-INFO

@@ -0,0 +1,199 @@
+Metadata-Version: 2.4
+Name: spark-agent
+Version: 0.9.6
+Summary: Spark [Ember] — local-first coding agent with a Codex-style loop
+License: MIT
+Keywords: ai,agent,coding,local-first,llm,chatbot
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: chromadb>=1.0
+Requires-Dist: instructor<2.0,>=1.4
+Requires-Dist: litellm<2.0,>=1.0
+Requires-Dist: llama-index-core<1.0,>=0.12
+Requires-Dist: llama-index-llms-openai-like<1.0,>=0.3
+Requires-Dist: httpx<1.0,>=0.27
+Requires-Dist: langgraph<1.0,>=0.3
+Requires-Dist: langgraph-checkpoint-sqlite<3.0,>=2.0
+Requires-Dist: mcp<2.0,>=1.0; python_version >= "3.10"
+Requires-Dist: pydantic<3.0,>=2.7
+Requires-Dist: pydantic-settings<3.0,>=2.0
+Requires-Dist: textual<1.0,>=0.80
+Requires-Dist: tomlkit<1.0,>=0.13
+Requires-Dist: tree-sitter<0.27,>=0.25
+Requires-Dist: tree-sitter-javascript<0.26,>=0.23
+Requires-Dist: tree-sitter-python<0.26,>=0.23
+Requires-Dist: tree-sitter-typescript<0.24,>=0.23
+Requires-Dist: typer<1.0,>=0.12
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: pytest-cov>=4.1; extra == "dev"
+Requires-Dist: ruff>=0.7; extra == "dev"
+Requires-Dist: import-linter>=2.0; extra == "dev"
+Requires-Dist: mypy>=1.11; extra == "dev"
+Requires-Dist: bandit>=1.7; extra == "dev"
+Requires-Dist: pre-commit>=3.6; extra == "dev"
+Provides-Extra: telemetry
+Requires-Dist: opentelemetry-api>=1.28; extra == "telemetry"
+Requires-Dist: opentelemetry-sdk>=1.28; extra == "telemetry"
+Requires-Dist: opentelemetry-exporter-otlp-proto-grpc>=1.28; extra == "telemetry"
+Provides-Extra: pty
+Requires-Dist: ptyprocess>=0.7; sys_platform != "win32" and extra == "pty"
+Provides-Extra: desktop
+Requires-Dist: pywebview>=5.0; extra == "desktop"
+Dynamic: license-file
+
+> 🌐 [English](README.md) | [中文](README_zh.md)
+
+# Spark — Local-first AI Coding Agent
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-brightgreen.svg)](https://www.python.org/)
+[![Node 18+](https://img.shields.io/badge/node-18%2B-339933.svg)](https://nodejs.org/)
+
+**Code stays with you. Keys stay with you.** A self-hosted AI coding assistant that runs entirely on your machine — zero privacy leaks, full control.
+
+## Core Values
+
+🔒 **Privacy First** — All code, conversation, and memory data stay entirely local. No third-party servers involved.  
+⚡ **Four Form Factors** — Web UI, native desktop window, terminal TUI, and scriptable CLI.  
+🧠 **Persistent Memory** — A vector memory store that remembers your project preferences, naming conventions, and workflow habits.  
+🔬 **Four-Level Sandbox** — From read-only analysis to full access, tunable by risk profile.  
+⏮️ **Checkpoint & Rollback** — Workspace snapshots plus conversation restore — jump to any previous state like Git.
+
+## Preview
+
+### Chat · driven by a real model
+
+> SSE streaming, Markdown code blocks, expandable tool-call cards, live context-usage meter.
+> This is a real session: the model read `pyproject.toml` and summarized the project — the `read_file` card shows ✓ Completed.
+
+![Chat](assets/screenshots/01-chat.png)
+
+### English UI · one-click switch
+
+> Built-in Chinese/English localization (Settings → Display → Language). Here the model chained
+> `read_file` + `glob` to survey the repo — both tool calls show Completed.
+
+![English UI](assets/screenshots/00-chat-en.png)
+
+### Settings · models and profiles
+
+> 8 built-in presets (DeepSeek / Qwen / GLM / Kimi / Doubao / Agnes / Ollama / custom),
+> multiple saved model profiles with one-click switching, a `Test connection` probe, and three reasoning-effort levels.
+
+![Settings · Model](assets/screenshots/02-settings-model.png)
+
+### Settings · permissions and sandbox
+
+> Four access levels: sandbox-only / workspace (recommended) / full-access / unrestricted,
+> each with an explicit behavior description. The protected-path list is user-editable and defaults to
+> `/etc`, `/root/.spark` and Spark's own source tree.
+
+![Settings · Permissions](assets/screenshots/03-settings-permissions.png)
+
+### Settings · display and customization
+
+> Light/dark/system theme, six display toggles (thinking / tools / plan card / context usage /
+> session keywords / notices), and a **fully customizable system prompt** (empty = built-in default).
+
+![Settings · Display](assets/screenshots/04-settings-display.png)
+
+### File viewer · syntax highlighting
+
+> Browse the workdir tree and preview files with line numbers and highlight.js syntax highlighting
+> (including correct coloring of multi-line tokens), file sizes, and graceful handling of binary/oversized files.
+
+![File viewer](assets/screenshots/05-file-viewer.png)
+
+### Windows EXE · no install required
+
+> Packaged with PyInstaller as a single executable (`dist/spark.exe`) — double-click to run, no Python needed.
+> Shown here: the model really invoked `run_shell`, read back the output `42`, and reported the exit code correctly.
+
+![EXE run](assets/screenshots/06-exe-tool-call.png)
+
+## Quick Start
+
+```bash
+git clone https://gitcode.com/badhope/spark        # 或 GitHub: https://github.com/badhope/spark
+cd spark && python3 -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
+pip install -e ".[dev]"
+spark web --workdir /your/project
+```
+
+Open the printed address in your browser. **Without an API key Spark starts in demo mode (mock);
+paste a key into the web settings and it switches to the real model immediately — no restart.**
+
+Windows users can also build a portable EXE (Python 3.11+):
+
+```powershell
+powershell -ExecutionPolicy Bypass -File scripts/build-windows.ps1
+dist\spark\spark.exe web                    # or just double-click dist\spark.exe
+```
+
+## Four Form Factors
+
+| Form | Command | Use case |
+|------|---------|----------|
+| Web UI | `spark web` | Everyday chat, file viewer, terminal, execution graph (auto-picks a free port) |
+| Desktop | `spark desktop` | Native window via pywebview, bound to loopback |
+| Terminal TUI | `spark` | Pure terminal environments, remote SSH |
+| CLI / scripts | `spark exec "task"` | Automation, CI, piping |
+| MCP server | `spark mcp-serve` | Expose every built-in tool to other MCP clients |
+
+## Feature Overview
+
+| Category | Features |
+|----------|----------|
+| Chat | SSE streaming, Markdown code blocks, image attachments, reasoning stream display |
+| Tools | File read/write, apply_edit with AST syntax gate, grep/glob, shell, background jobs, Jupyter, web search/fetch, full Git suite, worktrees |
+| Planning | Multi-step plans (PlanCard visualization), parallel sub-agent delegation (up to 4), declarative sub-agents (`.claude/agents/*.md`) |
+| Approval | Six approval modes (incl. plan-only / approve-plan), `[[permissions]]` wildcard rule engine, three-way approval dialog |
+| Permissions | Four-level sandbox, protected paths, credential-path protection, token-level shell checks, MCP least-privilege allowlists |
+| Memory | AGENTS.md injection, vector long-term memory (embeddings + optional reranker), auto-extraction, web-based management |
+| Persistence | Sessions, checkpoint rollback (works without git), hot config reload, token usage stats |
+| Models | Any OpenAI-compatible endpoint, local Ollama, multi-profile switching, `spark test` probe |
+| Extension | MCP client (stdio/SSE/HTTP + OAuth), MCP registry search (with China-availability ratings), project skills `.spark/skills/`, lifecycle hooks |
+| UI | Chinese/English, light/dark themes, command palette (Ctrl+K), file viewer, built-in terminal, web reader, execution graph, checkpoint panel |
+
+## Architecture
+
+![Architecture Overview](docs/assets/architecture.svg)
+
+Detailed architecture → [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)
+
+## Platform Requirements
+
+- Python 3.11+
+- Node.js 18+ (frontend development only; the bundled frontend ships prebuilt)
+- Any OpenAI-compatible API (DeepSeek, OpenAI, Ollama, Azure, Agnes, Unisound, SenseNova, …)
+- Windows / macOS / Linux (one-click EXE build on Windows)
+
+## Documentation
+
+| Document | Contents |
+|----------|----------|
+| [docs/INSTALL.md](docs/INSTALL.md) | Install & packaging (incl. Windows EXE) |
+| [docs/CONFIGURATION.md](docs/CONFIGURATION.md) | Configuration reference (config.toml / env vars / API overview) |
+| [docs/API.md](docs/API.md) | HTTP API and SSE event protocol |
+| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | Architecture notes |
+| [docs/competitive-comparison.md](docs/competitive-comparison.md) | Feature comparison vs Qoder / ZCode / opencode / Codex CLI |
+
+## Community
+
+- Contributing: [CONTRIBUTING.md](CONTRIBUTING.md)
+- Issue Tracker: use the **Issues** tab of this repository
+
+---
+
+**License:** MIT · **Author:** badhope · **Built with ❤️ in Shenzhen**

spark_agent-0.9.6/README.md

@@ -0,0 +1,145 @@
+> 🌐 [English](README.md) | [中文](README_zh.md)
+
+# Spark — Local-first AI Coding Agent
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-brightgreen.svg)](https://www.python.org/)
+[![Node 18+](https://img.shields.io/badge/node-18%2B-339933.svg)](https://nodejs.org/)
+
+**Code stays with you. Keys stay with you.** A self-hosted AI coding assistant that runs entirely on your machine — zero privacy leaks, full control.
+
+## Core Values
+
+🔒 **Privacy First** — All code, conversation, and memory data stay entirely local. No third-party servers involved.  
+⚡ **Four Form Factors** — Web UI, native desktop window, terminal TUI, and scriptable CLI.  
+🧠 **Persistent Memory** — A vector memory store that remembers your project preferences, naming conventions, and workflow habits.  
+🔬 **Four-Level Sandbox** — From read-only analysis to full access, tunable by risk profile.  
+⏮️ **Checkpoint & Rollback** — Workspace snapshots plus conversation restore — jump to any previous state like Git.
+
+## Preview
+
+### Chat · driven by a real model
+
+> SSE streaming, Markdown code blocks, expandable tool-call cards, live context-usage meter.
+> This is a real session: the model read `pyproject.toml` and summarized the project — the `read_file` card shows ✓ Completed.
+
+![Chat](assets/screenshots/01-chat.png)
+
+### English UI · one-click switch
+
+> Built-in Chinese/English localization (Settings → Display → Language). Here the model chained
+> `read_file` + `glob` to survey the repo — both tool calls show Completed.
+
+![English UI](assets/screenshots/00-chat-en.png)
+
+### Settings · models and profiles
+
+> 8 built-in presets (DeepSeek / Qwen / GLM / Kimi / Doubao / Agnes / Ollama / custom),
+> multiple saved model profiles with one-click switching, a `Test connection` probe, and three reasoning-effort levels.
+
+![Settings · Model](assets/screenshots/02-settings-model.png)
+
+### Settings · permissions and sandbox
+
+> Four access levels: sandbox-only / workspace (recommended) / full-access / unrestricted,
+> each with an explicit behavior description. The protected-path list is user-editable and defaults to
+> `/etc`, `/root/.spark` and Spark's own source tree.
+
+![Settings · Permissions](assets/screenshots/03-settings-permissions.png)
+
+### Settings · display and customization
+
+> Light/dark/system theme, six display toggles (thinking / tools / plan card / context usage /
+> session keywords / notices), and a **fully customizable system prompt** (empty = built-in default).
+
+![Settings · Display](assets/screenshots/04-settings-display.png)
+
+### File viewer · syntax highlighting
+
+> Browse the workdir tree and preview files with line numbers and highlight.js syntax highlighting
+> (including correct coloring of multi-line tokens), file sizes, and graceful handling of binary/oversized files.
+
+![File viewer](assets/screenshots/05-file-viewer.png)
+
+### Windows EXE · no install required
+
+> Packaged with PyInstaller as a single executable (`dist/spark.exe`) — double-click to run, no Python needed.
+> Shown here: the model really invoked `run_shell`, read back the output `42`, and reported the exit code correctly.
+
+![EXE run](assets/screenshots/06-exe-tool-call.png)
+
+## Quick Start
+
+```bash
+git clone https://gitcode.com/badhope/spark        # 或 GitHub: https://github.com/badhope/spark
+cd spark && python3 -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
+pip install -e ".[dev]"
+spark web --workdir /your/project
+```
+
+Open the printed address in your browser. **Without an API key Spark starts in demo mode (mock);
+paste a key into the web settings and it switches to the real model immediately — no restart.**
+
+Windows users can also build a portable EXE (Python 3.11+):
+
+```powershell
+powershell -ExecutionPolicy Bypass -File scripts/build-windows.ps1
+dist\spark\spark.exe web                    # or just double-click dist\spark.exe
+```
+
+## Four Form Factors
+
+| Form | Command | Use case |
+|------|---------|----------|
+| Web UI | `spark web` | Everyday chat, file viewer, terminal, execution graph (auto-picks a free port) |
+| Desktop | `spark desktop` | Native window via pywebview, bound to loopback |
+| Terminal TUI | `spark` | Pure terminal environments, remote SSH |
+| CLI / scripts | `spark exec "task"` | Automation, CI, piping |
+| MCP server | `spark mcp-serve` | Expose every built-in tool to other MCP clients |
+
+## Feature Overview
+
+| Category | Features |
+|----------|----------|
+| Chat | SSE streaming, Markdown code blocks, image attachments, reasoning stream display |
+| Tools | File read/write, apply_edit with AST syntax gate, grep/glob, shell, background jobs, Jupyter, web search/fetch, full Git suite, worktrees |
+| Planning | Multi-step plans (PlanCard visualization), parallel sub-agent delegation (up to 4), declarative sub-agents (`.claude/agents/*.md`) |
+| Approval | Six approval modes (incl. plan-only / approve-plan), `[[permissions]]` wildcard rule engine, three-way approval dialog |
+| Permissions | Four-level sandbox, protected paths, credential-path protection, token-level shell checks, MCP least-privilege allowlists |
+| Memory | AGENTS.md injection, vector long-term memory (embeddings + optional reranker), auto-extraction, web-based management |
+| Persistence | Sessions, checkpoint rollback (works without git), hot config reload, token usage stats |
+| Models | Any OpenAI-compatible endpoint, local Ollama, multi-profile switching, `spark test` probe |
+| Extension | MCP client (stdio/SSE/HTTP + OAuth), MCP registry search (with China-availability ratings), project skills `.spark/skills/`, lifecycle hooks |
+| UI | Chinese/English, light/dark themes, command palette (Ctrl+K), file viewer, built-in terminal, web reader, execution graph, checkpoint panel |
+
+## Architecture
+
+![Architecture Overview](docs/assets/architecture.svg)
+
+Detailed architecture → [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)
+
+## Platform Requirements
+
+- Python 3.11+
+- Node.js 18+ (frontend development only; the bundled frontend ships prebuilt)
+- Any OpenAI-compatible API (DeepSeek, OpenAI, Ollama, Azure, Agnes, Unisound, SenseNova, …)
+- Windows / macOS / Linux (one-click EXE build on Windows)
+
+## Documentation
+
+| Document | Contents |
+|----------|----------|
+| [docs/INSTALL.md](docs/INSTALL.md) | Install & packaging (incl. Windows EXE) |
+| [docs/CONFIGURATION.md](docs/CONFIGURATION.md) | Configuration reference (config.toml / env vars / API overview) |
+| [docs/API.md](docs/API.md) | HTTP API and SSE event protocol |
+| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | Architecture notes |
+| [docs/competitive-comparison.md](docs/competitive-comparison.md) | Feature comparison vs Qoder / ZCode / opencode / Codex CLI |
+
+## Community
+
+- Contributing: [CONTRIBUTING.md](CONTRIBUTING.md)
+- Issue Tracker: use the **Issues** tab of this repository
+
+---
+
+**License:** MIT · **Author:** badhope · **Built with ❤️ in Shenzhen**

spark_agent-0.9.6/pyproject.toml

@@ -0,0 +1,129 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "spark-agent"
+version = "0.9.6"
+description = "Spark [Ember] — local-first coding agent with a Codex-style loop"
+readme = "README.md"
+license = { text = "MIT" }
+keywords = ["ai", "agent", "coding", "local-first", "llm", "chatbot"]
+requires-python = ">=3.11"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Code Generators",
+]
+dependencies = [
+    "chromadb>=1.0",
+    "instructor>=1.4,<2.0",
+    "litellm>=1.0,<2.0",
+    "llama-index-core>=0.12,<1.0",
+    "llama-index-llms-openai-like>=0.3,<1.0",
+    "httpx>=0.27,<1.0",
+    "langgraph>=0.3,<1.0",
+    "langgraph-checkpoint-sqlite>=2.0,<3.0",
+    "mcp>=1.0,<2.0; python_version>=\"3.10\"",
+    "pydantic>=2.7,<3.0",
+    "pydantic-settings>=2.0,<3.0",
+    "textual>=0.80,<1.0",
+    "tomlkit>=0.13,<1.0",
+    "tree-sitter>=0.25,<0.27",
+    "tree-sitter-javascript>=0.23,<0.26",
+    "tree-sitter-python>=0.23,<0.26",
+    "tree-sitter-typescript>=0.23,<0.24",
+    "typer>=0.12,<1.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "pytest-cov>=4.1",
+    "ruff>=0.7",
+        "import-linter>=2.0",
+    "mypy>=1.11",
+    "bandit>=1.7",
+    "pre-commit>=3.6",
+]
+# P0-9: 观测（Langfuse 自托管 = OTLP 端点，spark 直接接入 OTLP 即可）
+telemetry = [
+    "opentelemetry-api>=1.28",
+    "opentelemetry-sdk>=1.28",
+    "opentelemetry-exporter-otlp-proto-grpc>=1.28",
+]
+# P1-5: 内置终端（真实 PTY）。Windows 不支持（需 winpty/ConPTY），
+# 故用环境标记排除；未安装时 spark.pty 可导入但 PtyManager() 给出清晰报错。
+pty = [
+    "ptyprocess>=0.7; sys_platform != 'win32'",
+]
+desktop = [
+    "pywebview>=5.0",
+]
+
+[project.scripts]
+spark = "spark.cli:app"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+spark = ["prompts/*.md", "web/*.html", "web/dist/*", "web/dist/assets/*", "evals/data/*.json"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+pythonpath = ["src"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = [
+    "E4",    # pycodestyle import errors
+    "E7",    # pycodestyle statement errors
+    "E9",    # pycodestyle runtime errors
+    "F",     # pyflakes
+    "I001",  # import sorting
+]
+ignore = []
+
+[tool.ruff.lint.per-file-ignores]
+# search.py deliberately defers pydantic/spark imports to avoid a circular
+# import at module load time.
+"src/spark/tools/search.py" = ["E402"]
+# 以下文件中 logger = logging.getLogger(__name__) 紧跟在 __future__ 与 stdlib
+# 导入之后、第三方/本地导入之前，避免 E402 噪音。
+"src/spark/core/graph.py" = ["E402"]
+"src/spark/memory/service.py" = ["E402"]
+"src/spark/tools/shell.py" = ["E402"]
+"src/spark/tui/app.py" = ["E402"]
+# routes.py 保持 import-light：pty 写路径在 _POST_HANDLERS 定义后就近懒加载，
+# 不为 import 排序把 pty 依赖提到模块顶部。
+"src/spark/web/routes.py" = ["E402", "I001"]
+
+[tool.mypy]
+python_version = "3.11"
+ignore_missing_imports = true
+warn_unused_ignores = false
+warn_return_any = false
+check_untyped_defs = false
+
+[[tool.mypy.overrides]]
+module = [
+    "chromadb.*",
+    "llama_index.*",
+    "langgraph.*",
+    "litellm.*",
+    "textual.*",
+    "typer.*",
+]
+ignore_missing_imports = true
+follow_imports = "skip"

spark_agent-0.9.6/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

spark_agent-0.9.6/src/spark/__init__.py

@@ -0,0 +1,14 @@
+"""Spark — local-first AI coding agent."""
+
+import os
+
+# Skip LiteLLM's model-cost-map fetch from raw.githubusercontent.com, which is
+# unreachable from mainland China and burns ~9s of connection retries on every
+# process start. The bundled local map ships in the wheel; users can opt back
+# into remote refreshes by setting the variable to False explicitly.
+# Must run before the first litellm import anywhere in the package (litellm
+# reads this variable at import time), so it lives at the package root —
+# every entry point (cli/web/desktop) imports spark first.
+os.environ.setdefault("LITELLM_LOCAL_MODEL_COST_MAP", "True")
+
+__version__ = "0.9.6"

spark_agent-0.9.6/src/spark/__main__.py

@@ -0,0 +1,4 @@
+from spark.cli import app
+
+if __name__ == "__main__":
+    app()