Skip to main content

​
Single Repository Setup

This guide will help you set up Simili Bot for a single repository. This is the Pattern A deployment model, which is the easiest way to get started.

​
Prerequisites

  • A GitHub repository where you have admin access.
  • Qdrant API Key & URL.
  • Gemini API Key.

​
Setup Steps

Follow these steps to enable AI-powered issue management.
1

Add Configuration

Create .github/simili.yaml in your repository root:
qdrant:
  url: "https://your-cluster.qdrant.io:6333"
  api_key: "${QDRANT_API_KEY}"
  collection: "my-repo-issues"

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

repositories:
  - org: "your-username"
    repo: "your-repo"
    enabled: true
2

Store Secrets

Go to Settings > Secrets and variables > Actions in your GitHub repository and add:
  • QDRANT_API_KEY
  • GEMINI_API_KEY
  • QDRANT_URL (optional, if not hardcoded in config)
3

Create Workflow

Create .github/workflows/simili-bot.yml with the following content:
name: Simili Bot
on:
  issues:
    types: [opened, edited]
jobs:
  simili:
    runs-on: ubuntu-latest
    permissions:
      issues: write
      contents: read
    steps:
      - uses: similigh/simili-bot@v0.1.0
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          QDRANT_API_KEY: ${{ secrets.QDRANT_API_KEY }}
          GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
4

Verification

Open a new issue in your repository. You should see Simili Bot comment within a few seconds with its analysis.

​
Troubleshooting

Check the Actions tab in your repository. If the workflow failed, review the logs for authentication or configuration errors.
Ensure your QDRANT_API_KEY and GEMINI_API_KEY are correctly set in the repository secrets and match the environment variable names in your workflow.

​
Next Steps

Configuration Overview

Feature Guides