{"id":48843953,"url":"https://github.com/wutsi/kokibot","last_synced_at":"2026-05-08T02:07:31.529Z","repository":{"id":350010324,"uuid":"1204886930","full_name":"wutsi/kokibot","owner":"wutsi","description":"AI personal assistant","archived":false,"fork":false,"pushed_at":"2026-05-01T22:06:40.000Z","size":1218,"stargazers_count":0,"open_issues_count":9,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-05-01T23:31:03.317Z","etag":null,"topics":["ai","assistant","chatbot"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wutsi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"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}},"created_at":"2026-04-08T12:34:34.000Z","updated_at":"2026-05-01T22:06:30.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/wutsi/kokibot","commit_stats":null,"previous_names":["wutsi/kokibot"],"tags_count":32,"template":false,"template_full_name":null,"purl":"pkg:github/wutsi/kokibot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wutsi%2Fkokibot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wutsi%2Fkokibot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wutsi%2Fkokibot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wutsi%2Fkokibot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wutsi","download_url":"https://codeload.github.com/wutsi/kokibot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wutsi%2Fkokibot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32575176,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T06:36:36.687Z","status":"ssl_error","status_checked_at":"2026-05-03T06:36:09.306Z","response_time":103,"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","assistant","chatbot"],"created_at":"2026-04-15T04:00:27.265Z","updated_at":"2026-05-03T16:06:03.515Z","avatar_url":"https://github.com/wutsi.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Kokibot\n\n### Your Extensible AI Assistant Framework\n\n*Build production-ready AI assistants with pluggable architecture for LLM providers, communication channels, and custom\ntools*\n\n[![release](https://github.com/wutsi/kokibot/actions/workflows/release.yml/badge.svg)](https://github.com/wutsi/kokibot/actions/workflows/release.yml)\n[![master](https://github.com/wutsi/kokibot/actions/workflows/master.yml/badge.svg)](https://github.com/wutsi/kokibot/actions/workflows/master.yml)\n[![pr](https://github.com/wutsi/kokibot/actions/workflows/pr.yml/badge.svg)](https://github.com/wutsi/kokibot/actions/workflows/pr.yml)\n[![JaCoCo Coverage](https://img.shields.io/badge/Coverage-93%25-brightgreen.svg)](target/site/jacoco/index.html)\n\n[![Kotlin](https://img.shields.io/badge/Kotlin-2.2.0-blue.svg?logo=kotlin)](https://kotlinlang.org)\n[![Java](https://img.shields.io/badge/Java-17-orange.svg?logo=openjdk)](https://openjdk.org/)\n[![Python](https://img.shields.io/badge/Python-3.x-orange.svg?logo=python)](https://python.org/)\n[![Spring Boot](https://img.shields.io/badge/Spring%20Boot-4.0.5-brightgreen.svg?logo=spring)](https://spring.io/projects/spring-boot)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\n[Features](#-key-features) • [Quick Start](#-quick-start) • [Documentation](#-documentation)\n\n\u003c/div\u003e\n\n---\n\n## Introduction\n\n**Kokibot** is a powerful, extensible AI assistant framework built with Kotlin and Spring Boot. It provides a pluggable\narchitecture that makes it easy to build production-ready AI assistants capable of complex reasoning, tool execution,\nand multi-channel communication.\n\n---\n\n## Quick Start\n\n### Step 0: Prerequisites\n\n- Homebrew (for macOS and Linux)\n- Java 17 or higher\n- Python 3.x (optional, for tools that require Python)\n\n### Step 1: Set Environment Variables\n\nSetup the following environment variables:\n\n```bash\nexport KOKIBOT_LLM_TYPE=\"your-llm-api-key\"        // Type of LLM: deepseek, kimi, gemini\nexport KOKIBOT_LLM_API_KEY=\"your-llm-api-key\"     // LLM API Key\nexport KOKIBOT_LLM_MODEL=\"your-llm-model\"         // LLM Model\n\nexport KOKIBOT_CHANNEL_TYPE=\"your-channel-type\"   // Type of channel: telegram\nexport KOKIBOT_TOKEN=\"your-channel-token\"         // Channel token: e.g., Telegram Bot Token\n```\n\n### Step 2: Install Kokibot (macOS \u0026 Linux)\n\nRun the following command in your terminal:\n\n```bash\ncurl -fsSL https://github.com/wutsi/kokibot/releases/latest/download/install.sh | bash\n```\n\nThis will automatically\n\n- Download the installation files\n- Install kokibot\n    - The binaries will be installed to `~/Application/kokikot`\n    - The configuration, logs and data will be stored in `~/.kokibot`\n- Run it a background service  (with `launchd` for macOS, `systemd` for Linux).\n\n---\n\n## Documentation\n\n### Directory Structure\n\n```\n.kokibot/\n   ASSISTANT.md                         # Assistant instructions\n   SECURITY.md                          # Security guidelines and restrictions for the agent\n   HEARTBEAT.md                         # Instruction of the heartbeat task executed frequently every day (Ex: ever hour)\n   config/\n     settings.json                      # Main configuration file for kokibot\n     tools/                             # Directory containing additional tools for the agent\n        {tool-name}.json                # Tool configuration file\n     instructions/                      # Directory containing additional instructions for the agent\n   skills/\n    {skill-name}/                       # Directory for each skill\n      SKILL.md                          # Skill instructions file\n   memory/\n     MEMORY.md                          # Agent long term memory. Maintained by the agent itself\n     history/\n       {yyyy}-{MM}-{dd}.log             # Daily conversation history. Maintained by the agent itself\n   workspace/                           # Working directory\n     files/                             # Directory for files created by tools/skillsv\n     tmp/                               # Temporary directory for intermediate files\n     logs/                              # Log directory\n       kokibot.log                      # Today's log file\n       kokibot-{yyyy}-{MM}-{dd}.log     # Archive of daily log files\n```\n\n### Supported LLM Providers\n\n- Deepseek v3, v4\n- Kimi\n- Gemini\n\n### Supported Communication Channels\n\n- Telegram\n- Email\n\n---\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Built with ❤️ by the Kokibot team**\n\n[⭐ Star us on GitHub](https://github.com/wutsi/kokibot) • [🐛 Report a Bug](https://github.com/wutsi/kokibot/issues) • [💡 Request a Feature](https://github.com/wutsi/kokibot/issues)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwutsi%2Fkokibot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwutsi%2Fkokibot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwutsi%2Fkokibot/lists"}