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

Prerequisites

• Qdrant — Vector database (free tier available)
• Gemini API Key — For embeddings (free tier available)

1. Add Secrets

Go to Settings → Secrets and variables → Actions and add:

2. Create Configuration

Create .github/simili.yaml:

qdrant:
  url: "${QDRANT_URL}"
  api_key: "${QDRANT_API_KEY}"
  collection: "my-repo-issues"

embedding:
  provider: "gemini"
  api_key: "${GEMINI_API_KEY}"

workflow: "issue-triage"

defaults:
  similarity_threshold: 0.65
  max_similar_to_show: 5

# Optional: specify repositories (omit for single-repo mode)
repositories:
  - org: "your-org"
    repo: "your-repo"
    enabled: true

3. Add Workflow

Create .github/workflows/simili.yml:

name: Simili Issue Intelligence

on:
  issues:
    types: [opened, edited, closed, reopened, deleted]

jobs:
  process:
    runs-on: ubuntu-latest
    permissions:
      issues: write
      contents: read

    steps:
      - uses: actions/checkout@v4

      - uses: similigh/simili-bot@v1
        with:
          config_path: .github/simili.yaml
        env:
          GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
          QDRANT_URL: ${{ secrets.QDRANT_URL }}
          QDRANT_API_KEY: ${{ secrets.QDRANT_API_KEY }}

📚 Documentation

🔧 Available Workflows

Or define custom steps:

steps:
  - gatekeeper
  - similarity_search
  - response_builder
  - indexer

🛠️ 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 with ❤️ by the Simili Team