README
¶
Simili Bot
AI-Powered GitHub Issue Intelligence
Automatically detect duplicate issues, find similar issues with semantic search, and intelligently route issues across repositories.
Features
- Semantic Duplicate Detection — Find related issues using AI-powered embeddings, not just keyword matching.
- Cross-Repository Search — Search for similar issues across your organization.
- Intelligent Routing — Automatically transfer issues to the correct repository based on content.
- Smart Triage — AI-powered labeling and quality assessment.
- Modular Pipeline — Customize workflows with plug-and-play steps.
- Multi-Repo Support — Central configuration with per-repo overrides.
Architecture
Simili uses a "Lego with Blueprints" architecture:
- Lego Blocks: Independent, reusable pipeline steps (Gatekeeper, Similarity, Triage, etc.).
- Blueprints: Pre-defined workflows for common use cases.
- State Branch: Git-based state management using an orphan branch (no comment scanning).
┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Gatekeeper │───▶│ Similarity │───▶│ Triage │───▶│ Action │
│ Check │ │ Search │ │ Analysis │ │ Executor │
└─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘
Quick Start
Simili-Bot supports both Single-Repository and Organization-wide setups.
Setup Guides
| Guide | Description |
|---|---|
| Single Repo Setup | Instructions for setting up Simili-Bot on a standalone repository. |
| Organization Setup | Best practices for deploying across an organization using Reusable Workflows. |
Examples
We provide copy-pasteable examples to get you started quickly:
- Multi-Repo Examples: Includes shared workflow, caller workflow, and central config.
- Single-Repo Examples: Standard workflow and configuration.
Available Workflows
You can specify a workflow in your simili.yaml or define custom steps.
| Preset | Description |
|---|---|
issue-triage |
Full pipeline: similarity search, duplicate check, triage analysis, and action execution. |
similarity-only |
Runs similarity search only. Useful for "Find Similar Issues" features without auto-triage. |
index-only |
Indexes issues to the vector database without providing feedback. |
Development
# Clone the repository
git clone https://github.com/similigh/simili-bot.git
cd simili-bot
# Build
go build ./...
# Run tests
go test ./...
# Lint
go vet ./...
License
This project is licensed under the Apache License 2.0 — see the LICENSE file for details.
Made by the Simili Team
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
simili
command
Package main is the entry point for the Simili-Bot CLI.
|
Package main is the entry point for the Simili-Bot CLI. |
|
internal
|
|
|
core/config
Package config handles loading and merging Simili configuration.
|
Package config handles loading and merging Simili configuration. |
|
core/pipeline
Package pipeline provides the core pipeline engine for Simili-Bot.
|
Package pipeline provides the core pipeline engine for Simili-Bot. |
|
core/state
Package state provides a GitHub API-based implementation of GitStateManager.
|
Package state provides a GitHub API-based implementation of GitStateManager. |
|
integrations/gemini
Package gemini provides Gemini AI integration for embeddings and LLM.
|
Package gemini provides Gemini AI integration for embeddings and LLM. |
|
integrations/qdrant
Package qdrant provides the vector database integration.
|
Package qdrant provides the vector database integration. |
|
steps
Package steps provides the action executor step.
|
Package steps provides the action executor step. |
|
transfer
Package transfer provides the transfer rules engine for cross-repository issue routing.
|
Package transfer provides the transfer rules engine for cross-repository issue routing. |
Click to show internal directories.
Click to hide internal directories.