whatisgithub

What is heychat?

rupak182/heychat — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

HeyChat is a local-first desktop app for chatting with multiple AI providers (Gemini, OpenAI, Groq, Anthropic, Ollama), keeping history and API keys stored securely on your own device.

Mindmap

mindmap
  root((heychat))
    What it does
      Local AI chat client
      Multi provider support
      Streaming responses
      Thread management
    Tech stack
      TypeScript
      React
      Rust
      Tauri
    Use cases
      Compare AI providers
      Local Ollama models
      Secure key storage
    Platforms
      Linux
      macOS
      Windows

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Chat with several AI providers from one lightweight desktop app instead of switching between web tabs.

USE CASE 2

Keep API keys out of plain text config files by storing them in your OS's native keychain.

USE CASE 3

Run local models through Ollama alongside cloud models like Gemini or OpenAI.

What is it built with?

TypeScriptReactRustTauriSQLite

How does it compare?

rupak182/heychat0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardeasy
Complexity3/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Building from source requires Rust, Cargo, and Bun plus OS-specific build tools, pre-built installers are simpler.

Use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

So what is it?

HeyChat is a desktop application for chatting with AI models, built with Tauri, React, and TypeScript. It works on Linux, macOS, and Windows, and stores your conversation history on your own computer using a local SQLite database rather than sending it to a remote server. The app lets you switch between several AI providers, including Google Gemini, OpenAI, Groq, Anthropic, and Ollama for models running on your own machine, plus any custom endpoint that follows the OpenAI API format. Responses stream in as they are generated, so replies appear word by word instead of all at once. You can create multiple chat threads, switch between them, and delete the ones you no longer need, all stored locally. API keys are not saved as plain text. Instead, HeyChat stores them in your operating system's built in keychain, such as macOS Keychain Access or the Windows Credential Manager, so the keys stay protected by your system's own security. The developers state that the app does not track, store, or transmit your credentials to any outside service. Other features include an always on top window option, so the chat can float above other apps while you code or browse, and formatted markdown responses that support tables, lists, links, and code blocks. The frontend is built with React, TypeScript, TailwindCSS, and Shadcn components, while the backend uses Tauri v2 with Rust, including the keyring crate for keychain access. AI features run through the Vercel AI SDK. To run a pre built version, you can download an installer from the project's Releases page for your operating system. To build it yourself, you need Rust, Cargo, and Bun or Node.js, along with your operating system's standard build tools. Development mode starts with a single command, and the same command family builds production installers for Linux, macOS, and Windows. The project is licensed under the MIT License, one of the most permissive open source licenses available.

Copy-paste prompts

Prompt 1
Help me set up HeyChat with Ollama so I can chat with a local model instead of a cloud API.
Prompt 2
Write a custom OpenAI-compatible endpoint config for HeyChat to connect to a self-hosted model gateway.
Prompt 3
Explain how HeyChat stores API keys in the OS keychain and how that differs from using a .env file.
Prompt 4
Walk me through building HeyChat from source on Linux, including the required system packages.

Frequently asked questions

What is heychat?

HeyChat is a local-first desktop app for chatting with multiple AI providers (Gemini, OpenAI, Groq, Anthropic, Ollama), keeping history and API keys stored securely on your own device.

What language is heychat written in?

Mainly TypeScript. The stack also includes TypeScript, React, Rust.

What license does heychat use?

Use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

How hard is heychat to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is heychat for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.