{"id":13619185,"url":"https://github.com/yohasebe/monadic-chat","last_synced_at":"2026-06-13T02:05:25.051Z","repository":{"id":177731632,"uuid":"644793837","full_name":"yohasebe/monadic-chat","owner":"yohasebe","description":"🤖 + 🐳 + 🐧 Monadic Chat is a locally hosted web application designed to create and utilize intelligent chatbots. By providing a Linux environment on Docker to LLMs, it enables code execution and advanced tasks that require external tools.","archived":false,"fork":false,"pushed_at":"2026-06-07T03:24:44.000Z","size":459536,"stargazers_count":68,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-06-07T05:06:52.281Z","etag":null,"topics":["ai","chat","framework","python","ruby"],"latest_commit_sha":null,"homepage":"https://yohasebe.github.io/monadic-chat/","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yohasebe.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"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},"funding":{"github":["yohasebe"],"ko_fi":"yohasebe","buy_me_a_coffee":"yohasebe"}},"created_at":"2023-05-24T09:14:27.000Z","updated_at":"2026-06-01T06:20:53.000Z","dependencies_parsed_at":"2023-10-15T04:55:44.309Z","dependency_job_id":"b9cd6edf-d41a-4746-95e6-01ada7f65832","html_url":"https://github.com/yohasebe/monadic-chat","commit_stats":null,"previous_names":["yohasebe/monadic-chat"],"tags_count":66,"template":false,"template_full_name":null,"purl":"pkg:github/yohasebe/monadic-chat","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yohasebe%2Fmonadic-chat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yohasebe%2Fmonadic-chat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yohasebe%2Fmonadic-chat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yohasebe%2Fmonadic-chat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yohasebe","download_url":"https://codeload.github.com/yohasebe/monadic-chat/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yohasebe%2Fmonadic-chat/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34041089,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-07T02:00:07.652Z","response_time":124,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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","chat","framework","python","ruby"],"created_at":"2024-08-01T21:00:35.946Z","updated_at":"2026-06-07T23:01:38.212Z","avatar_url":"https://github.com/yohasebe.png","language":"Ruby","funding_links":["https://github.com/sponsors/yohasebe","https://ko-fi.com/yohasebe","https://buymeacoffee.com/yohasebe"],"categories":["Ruby","Building","Open Source"],"sub_categories":["Tools","Bot Platforms"],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"https://raw.githubusercontent.com/yohasebe/monadic-chat/refs/heads/main/docs/assets/images/monadic-chat-logo.png\" width=\"700px\" alt=\"Monadic Chat Logo\"\u003e\n\n\u003ca href=\"https://github.com/yohasebe/monadic-chat/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/yohasebe/monadic-chat?include_prereleases\u0026style=for-the-badge\u0026cacheSeconds=3600\" alt=\"Release\"\u003e\u003c/a\u003e\n\u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/yohasebe/monadic-chat?style=for-the-badge\u0026cacheSeconds=3600\" alt=\"License\"\u003e\u003c/a\u003e\n\u003ca href=\"https://yohasebe.github.io/monadic-chat/#/developer/testing_guide\"\u003e\u003cimg src=\"https://img.shields.io/badge/tests-passing-success?style=for-the-badge\" alt=\"Tests\"\u003e\u003c/a\u003e\n\n  ---\n\n**🎯 Features** · [Multimodal](https://yohasebe.github.io/monadic-chat/#/basic-usage/basic-apps#multimodal-capabilities) · [PDF Knowledge Base](https://yohasebe.github.io/monadic-chat/#/basic-usage/pdf_storage) · [Web Search](https://yohasebe.github.io/monadic-chat/#/basic-usage/basic-apps#web-search-integration) · [Code Execution](https://yohasebe.github.io/monadic-chat/#/basic-usage/basic-apps#code-interpreter) · [Voice Chat](https://yohasebe.github.io/monadic-chat/#/basic-usage/basic-apps#voice-chat) · [Privacy Filter](https://yohasebe.github.io/monadic-chat/#/advanced-topics/privacy-filter)\n\n  **🤖 Providers** · OpenAI · Claude · Gemini · Mistral · Cohere · xAI · DeepSeek · Ollama\n\n  **🛠 Built with** · Ruby · Electron · Docker · Qdrant · WebSocket\n\n  ---\n\n  \u003cimg src=\"https://raw.githubusercontent.com/yohasebe/monadic-chat/refs/heads/main/docs/assets/images/basic-architecture.png\" width=\"800px\" alt=\"Monadic Chat Architecture\"\u003e\n\n\u003c/div\u003e\n\n## Overview\n\n**Monadic Chat** is a locally hosted web application for creating and utilizing intelligent chatbots. By providing AI models with a real Linux environment through Docker, it enables advanced tasks requiring external tools. With support for voice interaction, image/video processing, and AI-to-AI conversations, Monadic Chat serves both as an AI application platform and a framework for developing AI-powered applications.\n\n**Contextual Conversations**: Like monads in functional programming that wrap values with context, conversations in Monadic Chat can carry structured metadata (reasoning, topics, notes).\n\n**Conversations as Data**: Your conversations are persistent, portable data you own—not ephemeral sessions locked in a web service. Edit, delete, export, and import your conversation history freely.\n\n**Available for Mac, Windows, and Linux**\n\n📖 **[Documentation](https://yohasebe.github.io/monadic-chat)** (English/Japanese) · 📋 **[Changelog](https://yohasebe.github.io/monadic-chat/#/changelog)**\n\n## Getting Started\n\n### Installation\n\n1. **Download** the installer for your platform from [Releases](https://github.com/yohasebe/monadic-chat/releases)\n   - macOS: `.dmg` file (Apple Silicon)\n   - Windows: `.exe` installer\n   - Linux: `.deb` package (Debian/Ubuntu)\n\n2. **Install** and launch the application\n\n3. **Configure API keys** in Settings\n\n4. **Start using** built-in applications or create your own\n\n📖 **Detailed installation guide**: [Installation](https://yohasebe.github.io/monadic-chat/#/getting-started/installation)\n\n### Quick Start\n\nAfter installation:\n\n1. Click **Start** to launch the Docker environment\n2. Select an app from the sidebar (start with **Chat** or **Voice Chat**)\n3. Choose your AI provider (OpenAI, Claude, Gemini, etc.)\n4. Start chatting!\n\nFor offline use, install [Ollama](https://ollama.com/) and select it as your provider.\n\n\u003e ⚠️ **Upgrading from 1.0.0-beta.14 or earlier?** Version 1.0.0-beta.15 replaces the OpenAI embeddings + PGVector stack with a fully local pipeline (Qdrant + `multilingual-e5-base`). Help search no longer requires an OpenAI API key. **Existing local PDF data is not migrated automatically — re-upload your PDFs after upgrading.** See the [Changelog](https://yohasebe.github.io/monadic-chat/#/changelog) and [PDF Storage docs](https://yohasebe.github.io/monadic-chat/#/basic-usage/pdf_storage) for details.\n\n## Why Monadic Chat?\n\nUnlike web-based AI services or IDE-integrated assistants, Monadic Chat is a **locally-run AI platform** that gives you:\n\n1. **Use Your Preferred Tools**: Access real Docker containers to run code, install packages, and persist files.\n\n2. **Local Data Storage**: Store conversations, code, and files on your local machine, not in cloud services. Work offline with Ollama.\n\n3. **Extensible Platform**: Not just a chatbot—a framework for building custom AI applications with Monadic DSL.\n\n4. **Provider Independence**: Switch between 9 AI providers. Choose the best model for each task.\n\n**Perfect for**: Developers building AI tools, researchers needing reproducible environments, privacy-conscious teams, and anyone wanting full control over their AI infrastructure.\n\n## Features\n\n### Key Highlights\n\n- **🤖 Multi-Provider Support**: OpenAI, Claude, Gemini, Mistral, Cohere, xAI, DeepSeek, and Ollama\n- **🐧 Real Linux Environment**: AI agents can execute code, install packages, persist files, and maintain continuous context across turns in actual Docker containers.\n- **💬 Advanced Conversation Management**: Edit, export/import, and track conversation history with structured context\n- **🎙️ Voice Interaction**: Text-to-speech and speech-to-text with multiple providers and speaker diarization\n- **🖼️ Image \u0026 Video**: Generate, edit, and analyze images and videos using latest AI models, with intelligent session-based continuity for effortless iterative editing and remixing of generated content.\n- **📄 PDF Knowledge Base**: Store and query documents locally with Qdrant + on-device embeddings — no API key required\n- **🌐 Web Search Integration**: Native search in OpenAI, Claude, Gemini, and Grok\n- **🔒 Privacy Filter** (opt-in): Mask PII locally before sending to AI providers; restore in the response. Supports 9 languages via Microsoft Presidio + spaCy. See [Privacy Filter](https://yohasebe.github.io/monadic-chat/#/advanced-topics/privacy-filter).\n- **🔄 Automatic Updates**: In-app notifications and seamless update downloads\n\n### Featured Applications\n\nChat · Chat Plus · Code Interpreter · Coding Assistant · Research Assistant · Voice Chat · Jupyter Notebook · Auto Forge · Concept Visualizer · Syntax Tree · Video Generator · Math Tutor · PDF Navigator · Image Generator · Language Practice\n\n📖 **Full list and details**: [Basic Apps](https://yohasebe.github.io/monadic-chat/#/basic-usage/basic-apps) (30+ apps)\n\n### Extensibility\n\n- **Monadic DSL**: Create custom applications with declarative syntax\n- **Docker Integration**: Add your own containers and tools\n- **Ruby \u0026 Python**: Extend functionality with familiar languages\n- **MCP Server**: Integrate external tools and services via JSON-RPC 2.0\n\n📖 **Development guide**: [Advanced Topics](https://yohasebe.github.io/monadic-chat/#/advanced-topics/)\n\n## Documentation\n\n- 📖 **[Documentation](https://yohasebe.github.io/monadic-chat)** (English/Japanese)\n- 🚀 **[Getting Started](https://yohasebe.github.io/monadic-chat/#/getting-started/installation)**\n- 📚 **[Basic Usage](https://yohasebe.github.io/monadic-chat/#/basic-usage/basic-apps)**\n- 🐳 **[Docker Integration](https://yohasebe.github.io/monadic-chat/#/docker-integration/basic-architecture)**\n- 💡 **[Advanced Topics](https://yohasebe.github.io/monadic-chat/#/advanced-topics/)**\n- 📖 **[Reference](https://yohasebe.github.io/monadic-chat/#/reference/configuration)**\n- ❓ **[Frequently Asked Questions](https://yohasebe.github.io/monadic-chat/#/faq)**\n- 📝 **[Related blog posts](https://yohasebe.com/tags/monadic-chat/)**\n\n## Developer\n\nYoichiro HASEBE\n[yohasebe@gmail.com](mailto:yohasebe@gmail.com)\n\n## License\n\nThis software is available as open source under the terms of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyohasebe%2Fmonadic-chat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyohasebe%2Fmonadic-chat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyohasebe%2Fmonadic-chat/lists"}