https://github.com/janole/chat-bandit
The friendly and powerful desktop AI chatbot supporting both local and cloud AI models
https://github.com/janole/chat-bandit
chatbot electron llama-cpp llm node-llama-cpp ollama ollama-api openai openai-api
Last synced: 3 months ago
JSON representation
The friendly and powerful desktop AI chatbot supporting both local and cloud AI models
- Host: GitHub
- URL: https://github.com/janole/chat-bandit
- Owner: janole
- Created: 2025-06-25T10:18:18.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-07-18T09:31:47.000Z (5 months ago)
- Last Synced: 2025-07-18T11:23:04.915Z (5 months ago)
- Topics: chatbot, electron, llama-cpp, llm, node-llama-cpp, ollama, ollama-api, openai, openai-api
- Language: TypeScript
- Homepage: https://chatbandit.de
- Size: 7.5 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Welcome to Chat Bandit
**Chat Bandit** is an open-source, privacy-focused desktop AI assistant supporting both local and cloud AI models. It integrates local LLMs such as Ollama and llama.cpp and connects to cloud providers like OpenAI, Google AI, and OpenRouter, offering a seamless and customizable AI chatbot experience.

---
## Repository Structure
- **[`apps`](./apps)**
- [`electron`](./apps/electron): Desktop Electron app with React-based UI.
- [`landing-page`](./apps/landing-page): Next.js based landing page for the project.
- **[packages](./packages)**
- [`ai-core`](./packages/ai-core): Core AI logic and types.
- [`ai-chat`](./packages/ai-chat): React components and hooks for chat UI.
- [`ai-electron`](./packages/ai-electron): Electron IPC and backend integration.
- [`basic-app`](./packages/basic-app): UI primitives and layout components.
- [`try-catch`](./packages/try-catch): Utility for error handling.
---
## Features (in progress)
- Cross-platform Electron desktop app with smooth UI.
- Support for local AI models (llama.cpp, Ollama).
- Integration with cloud AI providers (OpenAI, Google AI, OpenRouter).
- Model management UI and download handling.
- Rich markdown chat interface with image support.
- Privacy-first design: all data stored locally.
- Auto-updates and multi-window support.
---
## Getting Started
### Electron App
```bash
cd apps/electron
npm install
npm run dev
```
### Landing Page
```bash
cd apps/landing-page
npm install
npm run dev
```
---
## Notes
- This project is a **work in progress**.
- APIs, UI, and features may change frequently.
- Contributions and feedback are welcome!
---
## License
This project is open-source and licensed under the MIT License.
---
Created and maintained by Jan Ole Suhr | [https://janole.com](https://janole.com) | info@chatbandit.de