GNU Affero General Public License v3.0

技术解读

以下内容由 GitRead 中文社区 编辑团队基于项目 README 与官方资料整理, 结合中文开发者的常见使用场景补充技术选型建议。具体以项目官方文档为准。

深度技术分析:askimo-ai/askimo 项目

项目背景与痛点

在当今快速发展的 AI 技术领域,Chatbot 与知识图谱检索已成为重要组成部分。然而,大多数现有的工具仅能提供单一功能,如单纯的语言对话或推荐系统。askimo-ai/askimo 项目则试图填补这一空白,它不仅仅提供聊天功能,还有多步流程规划、RAG (Retrieval-Augmented Generation) 搜索以及工具集成,旨在为用户提供一个更加全能且智能的交互体验。该项目支持多种 AI 模型,如 OpenAI、Claude、Gemini、Grok 等,有助于拓宽用户的工具选择并提升功能表现。

核心技术揭秘

该项目的核心在于多维集成与丰富的功能扩展,可以分为几个关键部分:Chat 模块、RAG 搜索、多步流程规划以及工具集成。下面我们将具体剖析这些部分的实现机制。

graph TD A[用户请求] --> B[RAG 搜索请求] B --> C{"返回结果"} C -->|"成功"| D[展示详情] C -->|"失败"| E[显示错误] F[用户输入] --> G[Chat 模块] G --> H{"生成回复"} H -->|"成功"| I[发送回复] H -->|"失败"| J[处理错误]
  • RAG 搜索:通过对知识图谱进行查询,增强回复的生成能力。用户提出的查询会经由 RAG 搜索引擎进行处理,并返回相关的内容以辅助生成更为精准的回复。

  • 多步流程规划:通过预定义的工作流,可以对该模块进行详细的计划和流程设计。例如,在一个特定的业务场景中,可能需要执行多个步骤的交互才能满足用户需求,该功能可以无缝地完成这些复杂的流程。

  • 工具集成:该项目集成了众多 AI 工具,如 OpenAI 的模型,这种协作方式不仅简化了开发流程,也为用户提供了一个无缝集成的多端解决方案。

功能亮点与差异

askimo-ai/askimo 项目的一大亮点在于其模块化的设计。开发者可以根据实际需求灵活调整和扩展功能。相比单一聚焦于聊天功能的系统,该框架提供了从检索、生成到工具集成的全链路支持,有助于用户更好地管理复杂场景中的多步交互流程。

在多步流程规划上,askimo 提供了高度的定制性,使得复杂任务可以通过灵活的工作流进行拆分和整合,有助于提升效率并降低开发和运维成本。

应用场景与落地建议

该项目特别适用于需要多步交互与复杂的检索需求的业务场景,比如客户服务、知识问答系统以及复杂的业务管理流程。在落地过程中,开发者需要重点关注系统的扩展性与稳定性,以及在访问高负载或数据密集型应用时的表现。另外,考虑到多工具集成的复杂性,建议在设计阶段就充分考虑相关因素,以确保系统的高效运行。

综合评价

优点

  1. 全链路覆盖:从检索到生成,再到工具集成的全流程支持,极大丰富了应用场景。
  2. 模块化设计:高度灵活性,方便进行定制化开发。
  3. 丰富工具集:大量工具的集成提高了开发效率,简化了流程规划和执行。

缺点

  1. 复杂性高:对于初学者而言,复杂的流程规划工具集成可能构成一定的挑战。
  2. 性能考量:高负载场景下,系统表现需更充分调优,确保稳定性。

总体而言,askimo-ai/askimo 项目以其独特的多步流程和丰富的工具集成为业内的一匹黑马,展现出强大的发展潜力与广泛的应用前景。

关于

GitHub 原始描述(英文)

Chat, RAG search, multi-step Plans workflows, MCP tools, and Agents integration. Supports OpenAI, Claude, Gemini, Grok, Ollama, LM Studio and more

描述取自 GitHub 官方 API,保持仓库作者书写的原文。

语言占比

C
C++
Gherkin
Java
Kotlin
PowerShell
Shell

Release

README

Askimo - AI toolkit for your workflows.

One app. Every AI model. Your files stay local.

Chat · Search your files and the web · Run scripts · Build multi-step AI workflows · Execute AI agent skills - all offline-capable, all on your machine.

⭐ If Askimo saves you time, a star helps others find it - and keeps the project going. Star on GitHub →

Build License Release DCO

Total Downloads macOS Windows Linux

OpenAI Claude Gemini Grok Ollama LMStudio DockerAI OpenRouter NVIDIA NIM Together AI vLLM Server OpenAI-Compatible

📥 Download • 📖 Documentation • 💬 Discussions

askimo-ai/askimo | Trendshift


Why Askimo?

You shouldn’t have to choose between the best AI model, your privacy, and getting real work done.

  • One app, every model. Stop juggling browser tabs. Chat with OpenAI, Claude, Gemini, Grok, or a local Ollama model, switch in seconds, no copy-pasting.
  • Built as a native desktop app. Not a web wrapper. Starts fast, runs lean, and stays responsive even after hours of use and thousands of messages in a single conversation.
  • Long conversations that actually work. No crashes, no tab reloads, no lost context. Askimo handles deep, extended sessions the way a real desktop app should.
  • More than just chat. Delegate real work to autonomous agent CLIs (Claude Code, Codex, Antigravity), chain multi-step AI Plans from a form UI, and connect MCP tools, all from the same app.
  • Skills, managed once, used everywhere. Define a skill independently of any single agent, then run it with whichever agent CLI fits the job. No per-agent duplication or lock-in.
  • Talk to it, not just type. Dictate messages and have responses read back to you. Fully local/offline speech-to-text and text-to-speech options included.

🔒 Privacy by design. Your files, RAG index, conversation history, and telemetry all stay on your machine, nothing is uploaded, ever. Local RAG, local SQLite storage, local usage/cost tracking. The only network calls are the ones you configure (your chosen AI provider).


See It in Action

Agents - select the installed agent CLI and delegate a goal:

Askimo Agents Demo

RAG - search and chat with your local files:

Askimo RAG Demo

MCP tools - connect any MCP-compatible server:

Askimo MCP Demo

Provider Configure Directive Management Recording


Quick Start

Download for macOS, Windows, or Linux →

  1. Install and open Askimo
  2. Add a provider - paste an API key (OpenAI, Claude, Gemini…) or point it at a running Ollama instance
  3. Start chatting

Full setup guide →

System Requirements

OS macOS 11+, Windows 10+, Linux (Ubuntu 20.04+, Debian 11+, Fedora 35+)
Memory 50–300 MB (AI models require additional memory depending on provider)
Disk 250 MB

Features

AI & Providers

  • Multi-provider - Switch between OpenAI, Claude, Gemini, Grok, Ollama, LM Studio, Docker AI, OpenRouter, NVIDIA NIM, Together AI, vLLM Server, or any OpenAI-compatible endpoint per session
  • Vision - Attach images to conversations; works with any multimodal model

Search & Data

  • Web search (multiple backends) - Search the web with DuckDuckGo (no API key), Brave Search API, Tavily, Serply, or your own SearxNG instance
  • Local RAG - Index local folders, files, and web URLs. Hybrid BM25 + vector retrieval with an AI classifier that skips retrieval when the query doesn’t need it. Your data never leaves your machine.

Workflows & Extensibility

  • Plans (agentic workflows) - Chain multi-step AI pipelines from a form UI. Each step builds on the previous; progress shown live. Export as PDF or Word. Define your own plans in YAML or generate them by describing your workflow in plain English.
  • Script runner - Execute Python, Bash, and JavaScript from chat. Python runs in an auto-managed virtualenv with automatic dependency installation.
  • MCP tool integration - Connect MCP-compatible servers via stdio or HTTP

AI Agents (CLI)

  • Run autonomous coding agents - Delegate a goal to Claude Code, OpenAI Codex, or Google Antigravity directly from Askimo, with live streamed tool calls, thinking, and status
  • Reusable skills - Define a skill once and materialize it into any supported agent’s native skill-discovery folder, so it’s just as invocable there as in Askimo’s own chat

Voice

  • Speech-to-text - Dictate messages via OpenAI’s transcription API or a fully local/offline built-in Whisper engine (whisper.cpp)
  • Text-to-speech - Have AI responses read aloud via OpenAI’s TTS API or a fully local/offline Piper endpoint, with optional auto-play for hands-free “conversation mode”

Reliability & Privacy

  • Persistent sessions - Conversations stored in a local SQLite database, restored on restart
  • Local telemetry - Token usage, cost estimates, RAG performance per provider. Nothing uploaded.
  • i18n - English, Chinese (Simplified & Traditional), Japanese, Korean, French, Spanish, German, Portuguese, Vietnamese

Building from Source

Prerequisites

  • JDK 25+
  • Git
git clone https://github.com/askimo-ai/askimo.git
cd askimo

# Run the desktop app
./gradlew :desktop:run

# Build native installers
./gradlew :desktop:package

Project Structure

Module Description
desktop/ Compose Multiplatform desktop application
desktop-shared/ Shared UI components
shared/ Kotlin Multiplatform common module: domain models/DTOs, chat types, event bus, and shared utils used by both JVM and other targets
shared-jvm/ Core: providers, RAG, MCP, memory, tools, database, plans engine, skills & agent runtimes

See CONTRIBUTING.md for development guidelines and DCO requirements, or the Development Getting Started Guide.


Localization

English · 中文 (简体/繁體) · 日本語 · 한국어 · Français · Español · Deutsch · Português · Tiếng Việt

Translations are managed on Crowdin. Contributions welcome - no coding required.

Crowdin

Help translate Askimo →


License

AGPLv3. See LICENSE.


Contributing

Bug reports, feature requests, and pull requests are welcome. See CONTRIBUTING.md for details.


Star History

Star History Chart

Contributors

评论

暂无评论