{"id":47748452,"url":"https://github.com/cognisn/spark","last_synced_at":"2026-04-15T01:00:58.423Z","repository":{"id":348446505,"uuid":"1195616979","full_name":"Cognisn/spark","owner":"Cognisn","description":"Secure Personal AI Research Kit — Multi-provider LLM web interface with MCP tools, voice chat, persistent memory, and autonomous actions","archived":false,"fork":false,"pushed_at":"2026-04-12T06:37:20.000Z","size":605,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-12T08:16:09.352Z","etag":null,"topics":["ai","ai-tools","anthropic","autonomous-agents","aws-bedrock","chatbot","claude","fastapi","gemini","grok","llm","mcp","model-context-protocol","ollama","prompt-caching","python","rag","research-kit","voice-assistant","web-ui"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Cognisn.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/security.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-29T21:55:58.000Z","updated_at":"2026-04-06T02:16:15.000Z","dependencies_parsed_at":null,"dependency_job_id":"b2ee8d87-b045-48bb-a895-79019eb3a9be","html_url":"https://github.com/Cognisn/spark","commit_stats":null,"previous_names":["cognisn/spark"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/Cognisn/spark","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cognisn%2Fspark","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cognisn%2Fspark/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cognisn%2Fspark/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cognisn%2Fspark/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cognisn","download_url":"https://codeload.github.com/Cognisn/spark/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cognisn%2Fspark/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31821685,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T18:05:02.291Z","status":"ssl_error","status_checked_at":"2026-04-14T18:05:01.765Z","response_time":153,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-tools","anthropic","autonomous-agents","aws-bedrock","chatbot","claude","fastapi","gemini","grok","llm","mcp","model-context-protocol","ollama","prompt-caching","python","rag","research-kit","voice-assistant","web-ui"],"created_at":"2026-04-03T02:05:01.547Z","updated_at":"2026-04-15T01:00:58.401Z","avatar_url":"https://github.com/Cognisn.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Spark\n\n[![License: MIT + Commons Clause](https://img.shields.io/badge/License-MIT%20%2B%20Commons%20Clause-blue.svg)](LICENSE)\n[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)\n[![PyPI](https://img.shields.io/pypi/v/cognisn-spark.svg)](https://pypi.org/project/cognisn-spark/)\n[![CI](https://github.com/Cognisn/spark/actions/workflows/ci.yml/badge.svg)](https://github.com/Cognisn/spark/actions/workflows/ci.yml)\n[![Quality Gate](https://sonarcloud.io/api/project_badges/measure?project=Cognisn_spark\u0026metric=alert_status)](https://sonarcloud.io/summary/overall?id=Cognisn_spark)\n[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=Cognisn_spark\u0026metric=security_rating)](https://sonarcloud.io/summary/overall?id=Cognisn_spark)\n[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=Cognisn_spark\u0026metric=reliability_rating)](https://sonarcloud.io/summary/overall?id=Cognisn_spark)\n[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=Cognisn_spark\u0026metric=sqale_rating)](https://sonarcloud.io/summary/overall?id=Cognisn_spark)\n[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=Cognisn_spark\u0026metric=vulnerabilities)](https://sonarcloud.io/summary/overall?id=Cognisn_spark)\n[![Bugs](https://sonarcloud.io/api/project_badges/measure?project=Cognisn_spark\u0026metric=bugs)](https://sonarcloud.io/summary/overall?id=Cognisn_spark)\n\n**Spark** is a secure, multi-provider AI research kit with a modern web interface. It connects to AI models from Anthropic, AWS Bedrock, Google Gemini, Ollama, and X.AI, with features like MCP tool integration, intelligent context management, persistent memory, and autonomous scheduled actions.\n\n## Features\n\n### Conversations\n- **Multi-Provider LLM Support** -- Claude, Gemini, Grok, Llama, Mistral, and more\n- **Real-Time Streaming** -- Server-Sent Events for token-by-token responses\n- **Dark/Light Theme** -- Cognisn design system with theme persistence\n- **Context Compaction** -- LLM-driven summarisation when approaching context limits\n- **Conversation Linking** -- Share context between related conversations\n- **Favourites** -- Star conversations for quick access\n- **Global System Instructions** -- Define persistent instructions applied to all conversations (Settings \u003e Conversation)\n- **Voice Conversation Mode** -- Hands-free AI interaction via the headset button with text-to-speech output and voice selection\n- **Speech-to-Text Input** -- Dictate messages using the microphone button\n\n### Tools\n- **MCP Integration** -- Connect external tool servers via stdio, HTTP, or SSE\n- **Built-in Tools** -- Filesystem, documents (Word/Excel/PDF/PowerPoint), web search, archives\n- **Memory Tools** -- Persistent semantic memory across conversations\n- **Per-Conversation Control** -- Enable/disable tools at the server or individual level\n- **Tool Approval** -- Permission prompts for first-use with allow once/always/deny\n- **Tool Activity Sidecar Panel** -- Dedicated panel for tool call visibility, replacing inline tool groups\n- **Tool Documentation** -- Built-in `get_tool_documentation` tool for querying tool usage information\n- **Web Search Engines** -- DuckDuckGo, Brave, Google/SerpAPI, Bing/Azure, SearXNG\n\n### Memory\n- **Persistent Storage** -- Facts, preferences, projects, instructions, relationships\n- **Semantic Search** -- Vector embeddings for relevant recall\n- **Auto-Retrieval** -- Relevant memories silently injected into context\n- **Import/Export** -- JSON format for backup and sharing\n\n### Autonomous Actions\n- **Scheduled Tasks** -- Cron or one-off schedules via APScheduler\n- **AI-Assisted Creation** -- Describe what you want and the AI builds the action\n- **Background Daemon** -- System tray icon (macOS/Windows) runs actions independently\n- **Run History** -- Track execution status, results, and token usage\n\n### Dashboard\n- **Provider Models Modal** -- Click any provider on the dashboard to view its available models\n\n### Security\n- **Prompt Inspection** -- Pattern and keyword-based threat detection\n- **Secret Management** -- API keys stored in OS keychain, never in config files\n- **Settings Lock** -- Password-protect the settings page\n- **Tool Permissions** -- Per-conversation, per-tool approval system\n\n### Updates\n- **Auto-Update Checker** -- Checks GitHub releases for new versions; update from the Help menu\n\n## Installation\n\n### Download (Standalone)\n\nPre-built binaries with an embedded Python runtime and a native splash screen for first-run setup. Dependencies are downloaded from PyPI on first launch (~30-60 seconds, requires internet).\n\n| Platform | Architecture | Format | Download |\n|----------|-------------|--------|----------|\n| macOS | ARM64 (Apple Silicon) | Signed + notarized DMG | [Download](https://github.com/Cognisn/spark/releases/latest) |\n| macOS | x86_64 (Intel) | Signed + notarized DMG | [Download](https://github.com/Cognisn/spark/releases/latest) |\n| Windows | x86_64 | NSIS installer | [Download](https://github.com/Cognisn/spark/releases/latest) |\n| Linux | Any | pip install (see below) | -- |\n\n### Install from PyPI\n\n```bash\npip install cognisn-spark\n```\n\n#### Optional database drivers\n\n```bash\npip install cognisn-spark[postgresql]   # PostgreSQL\npip install cognisn-spark[mysql]        # MySQL\npip install cognisn-spark[mssql]        # SQL Server\npip install cognisn-spark[all-databases] # All drivers\n```\n\n## Quick Start\n\n```bash\nspark\n```\n\nOn first launch, Spark creates a configuration file, starts the web server on a random port, and opens your browser. Follow the welcome page to configure an LLM provider and start chatting.\n\n### Configuration\n\nSpark stores its configuration in platform-standard locations:\n\n| Platform | Config | Data | Logs |\n|----------|--------|------|------|\n| macOS | ~/Library/Application Support/spark/ | ~/Library/Application Support/spark/ | ~/Library/Logs/spark/ |\n| Linux | ~/.config/spark/ | ~/.local/share/spark/ | ~/.local/state/spark/logs/ |\n| Windows | %APPDATA%/spark/ | %APPDATA%/spark/ | %LOCALAPPDATA%/spark/logs/ |\n\nAPI keys are stored in the OS keychain (macOS Keychain, Windows Credential Locker, Linux Secret Service) via the [cognisn-konfig](https://pypi.org/project/cognisn-konfig/) library.\n\n## Architecture\n\n```mermaid\ngraph TB\n    subgraph UI [\"Web Interface\"]\n        FE[\"FastAPI + SSE + Bootstrap 5 (Cognisn)\"]\n        Voice[\"Voice / Speech-to-Text\"]\n        Sidecar[\"Tool Activity Sidecar\"]\n    end\n\n    subgraph Core [\"Conversation Manager\"]\n        CM[\"Context Compaction / Memory / RAG / Tool Routing\"]\n    end\n\n    subgraph Providers [\"LLM Providers\"]\n        Bedrock[\"AWS Bedrock\"]\n        Anthropic[\"Anthropic\"]\n        Ollama[\"Ollama\"]\n        Gemini[\"Google Gemini\"]\n        XAI[\"X.AI\"]\n    end\n\n    subgraph Tools [\"Tools\"]\n        MCP[\"MCP Servers\"]\n        Builtin[\"Built-in Tools\"]\n        Memory[\"Memory\"]\n        WebSearch[\"Web Search\"]\n    end\n\n    subgraph Foundation [\"cognisn-konfig\"]\n        Settings[\"Settings\"]\n        Secrets[\"Secrets\"]\n        Logging[\"Logging\"]\n    end\n\n    UI --\u003e Core\n    Core --\u003e Providers\n    Core --\u003e Tools\n    Core --\u003e Foundation\n```\n\n## Keyboard Shortcuts\n\n| Shortcut | Action |\n|----------|--------|\n| Ctrl/Cmd + K | Go to Conversations |\n| Ctrl/Cmd + N | New Conversation |\n| Ctrl/Cmd + , | Open Settings |\n| Enter | Send message |\n| Shift + Enter | New line |\n\n## Development\n\n```bash\ngit clone https://github.com/Cognisn/spark.git\ncd spark\npython -m venv .venv\nsource .venv/bin/activate\npip install -e \".[dev]\"\npytest\n```\n\n## Changelog\n\nSee [CHANGELOG.md](CHANGELOG.md).\n\n## Licence\n\nMIT License with Commons Clause -- free for personal and educational use. Commercial use requires a licence from the author. See [LICENSE](LICENSE).\n\n## Author\n\nMatthew Westwood-Hill / [Cognisn](https://github.com/Cognisn)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcognisn%2Fspark","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcognisn%2Fspark","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcognisn%2Fspark/lists"}