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