Skip to content

stepandel/chroma-explorer

Repository files navigation

 ██████╗██╗  ██╗██████╗  ██████╗ ███╗   ███╗ █████╗
██╔════╝██║  ██║██╔══██╗██╔═══██╗████╗ ████║██╔══██╗
██║     ███████║██████╔╝██║   ██║██╔████╔██║███████║
██║     ██╔══██║██╔══██╗██║   ██║██║╚██╔╝██║██╔══██║
╚██████╗██║  ██║██║  ██║╚██████╔╝██║ ╚═╝ ██║██║  ██║
 ╚═════╝╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚═╝     ╚═╝╚═╝  ╚═╝

███████╗██╗  ██╗██████╗ ██╗      ██████╗ ██████╗ ███████╗██████╗
██╔════╝╚██╗██╔╝██╔══██╗██║     ██╔═══██╗██╔══██╗██╔════╝██╔══██╗
█████╗   ╚███╔╝ ██████╔╝██║     ██║   ██║██████╔╝█████╗  ██████╔╝
██╔══╝   ██╔██╗ ██╔═══╝ ██║     ██║   ██║██╔══██╗██╔══╝  ██╔══██╗
███████╗██╔╝ ██╗██║     ███████╗╚██████╔╝██║  ██║███████╗██║  ██║
╚══════╝╚═╝  ╚═╝╚═╝     ╚══════╝ ╚═════╝ ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝

A desktop application for exploring and managing ChromaDB vector databases. Built with Electron and React.

Chroma Explorer

Features

  • Multi-Profile Connections - Connect to local, remote, or Chroma Cloud databases with saved profiles
  • Collection Management - Create, copy, delete, and configure collections with custom embedding functions
  • Document Operations - Browse, search, create, edit, and delete documents with batch support
  • Semantic Search - Query documents using natural language with 13+ embedding providers
  • Metadata Filtering - Filter documents with flexible query syntax
  • Resizable Layout - Adjustable multi-panel interface with sidebar, table, and detail views

Supported Embedding Providers

OpenAI, Cohere, Google Gemini, Ollama, HuggingFace Server, Mistral, Voyage AI, Together AI, Jina, Cloudflare Workers AI, Morph, Chroma Cloud Qwen, Sentence Transformer

Tech Stack

  • Desktop: Electron
  • Frontend: React, TypeScript, Tailwind CSS
  • Data: TanStack Query, TanStack Table
  • UI: Radix UI components, Lucide icons
  • Database: ChromaDB SDK

Project Structure

├── electron/           # Main process (IPC handlers, ChromaDB service, window management)
├── src/
│   ├── windows/       # Window components (Setup, Connection, Settings)
│   ├── components/    # UI components (collections, documents, modals)
│   ├── context/       # React contexts (ChromaDB, Collections, Documents)
│   ├── hooks/         # Custom hooks
│   └── providers/     # Context providers

Development

# Install dependencies
pnpm install

# Start development server
pnpm dev

# Build for production
pnpm build

Configuration

API keys for embedding providers can be configured in Settings (Cmd+,). Keys are stored encrypted at rest.

License

MIT