Skip to content

A cross-platform desktop client supporting multiple LLM providers, integrated with AI search, developer tools, and third-party AI tool access.一款支持多种大模型(LLM)提供商的跨平台桌面客户端。同时集成AI 搜索、开发者工具集与第三方 AI 工具入口。

License

Notifications You must be signed in to change notification settings

zeeklog/zeek.ai

Repository files navigation

🚀 Zeek.ai Desktop App

中文English

Zeek.ai is a desktop client that supports for multiple LLM providers, available on Windows, Mac and Linux. Leveraging a modular Monorepo architecture, it delivers a lightweight, extensible, and high-performance desktop experience for AI-driven workflows.

Awesome GitHub Stars GitHub Forks GitHub Issues License Release

💪 FN Under Development

  • Supports the configuration for connecting to various AI agents, such as ChatGPT, Grok, Kimi, Ollama, etc.
  • Supports connection to model suppliers.
  • Supports model switching, and also supports functions like text-to-image, image-to-text, text-to-video, etc.
  • Supports video painting.

Ai search

Zeek.ai Banner

Ai agent for Popular supplier

ai-agent-config.png

📊 Key Metrics

  • Downloads: releases
  • Open Issues: GitHub Issues
  • Pull Requests: GitHub PRs
  • Last Commit: GitHub Last Commit
  • Contributors: GitHub Contributors

🛠️ Tech Stack


📂 Project Structure

Zeek.ai uses a Monorepo architecture under packages/ for modularity and scalability:

Module Description Tech Stack
packages/main Electron main process: Window management, IPC, and app lifecycle Node.js, Electron
packages/renderer UI renderer with submodules for core UI and tools Vue 3, Vite, Element Plus
packages/preload Preload scripts bridging main and renderer securely Node.js, Electron
packages/electron-version Manages Electron version compatibility Node.js
packages/integrate-renderer Automates renderer integration for builds and dev Vite, Custom Scripts
packages/chat Ai agent chat, support a lot of supplier. (Mix Component from LibreChat) React

Renderer Submodules

  • renderer/basic: Core UI framework with AI tool execution
    AI Search
  • renderer/tools: Extensible tools and plugins
    Tools
  • renderer/chat: Extensible ai agent ai-agent-example.png

✨ Features

  • Cross-Platform: Windows, macOS, Linux support via Electron Builder
  • Hot Reloading: Real-time updates for main and renderer in dev mode
  • Modular Design: Monorepo structure for easy feature expansion
  • Auto Updates: Built-in online update system with Electron Updater
  • Performance: Lightweight footprint with Vite’s optimized builds

⚙️ Getting Started

Prerequisites

  • Node.js: >= 20.0.0
  • OS: Windows, macOS, or Linux

Installation

# Clone the repository
git clone https://github.com/zeeklog/zeek.ai.git

# Navigate to the project
cd zeek.ai

# Install dependencies
npm install --legacy-peer-deps
# or you want to use pnpm
pnpm install

Development

Start dev server (main + renderer)

npm run dev Main app launches with Electron Renderer available at http://localhost:5173

Build

Build for Windows

npm run build:win

Build for macOS

npm run build:mac

Build for Linux

npm run build:linux

📜 Scripts

Command Description
npm run dev Start dev mode with hot reloading
npm run build Build all modules for production
npm run build:win Package for Windows
npm run build:mac Package for macOS
npm run build:linux Package for Linux
npm run test Run E2E tests
npm run create-renderer Scaffold a new renderer module
npm run integrate Integrate renderer into Electron app

📦 Releases

  • Latest: v0.1.1 (April 2025)
  • Supported Formats:
    • Windows: NSIS Installer
    • macOS: DMG (Signed)(MAC intel chip is not supporting.)
    • Linux: DEB (System Tools Category)

Auto-updates are enabled via electron-updater. Check releases for changelogs and binaries.


🤝 Contributing

We welcome contributions! Here’s how to get involved:

  1. Fork the repo
  2. Create a feature branch (git checkout -b feature/xyz)
  3. Commit changes (git commit -m "Add XYZ")
  4. Push to your fork (git push origin feature/xyz)
  5. Open a Pull Request
  6. Issues: Report a bug

🌐 Community

🚀 Contributors



📄 License

Zeek.ai is licensed under the MIT License. Feel free to use, modify, and distribute!


🙌 Acknowledgments

  • Built with ❤️ by Neo
  • Thanks to the open-source community for providing tools such as Electron, Vite, and Vue, as well as the numerous unmentioned open-source tools, libraries, code, and more used in the project.

About

A cross-platform desktop client supporting multiple LLM providers, integrated with AI search, developer tools, and third-party AI tool access.一款支持多种大模型(LLM)提供商的跨平台桌面客户端。同时集成AI 搜索、开发者工具集与第三方 AI 工具入口。

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published