> ## Documentation Index
> Fetch the complete documentation index at: https://simili.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Choose Your Setup

> Find the right implementation pattern for your needs

# Choose Your Setup

Simili Bot supports three distinct deployment patterns. Choosing the right one depends on your organization's size, security requirements, and team structure.

## Decision tree

Use this diagram to quickly identify the best pattern for your current needs.

```mermaid theme={null}
graph TD
    start["How many repositories<br/>do you need to manage?"]

    start -->|One| patternA["Pattern A:<br/>Single Repository<br/><br/>✓ Simple setup<br/>✓ Self-contained<br/>✓ Default permissions"]

    start -->|Multiple| question["Where should<br/>processing happen?"]

    question -->|In each repo<br/>separately| patternC["Pattern C:<br/>Distributed Multi-Repo<br/><br/>✓ Team autonomy<br/>✓ Shared cross-repo search<br/>✓ Config inheritance"]

    question -->|Centralized<br/>location| patternB["Pattern B:<br/>Centralized Multi-Repo<br/><br/>✓ Org-wide control<br/>✓ Unified processing<br/>⚠️ Elevated permissions"]

    patternA -->|Next| setupA["Single-Repo<br/>Setup Guide"]
    patternC -->|Next| setupC["Distributed<br/>Setup Guide"]
    patternB -->|Next| setupB["Centralized<br/>Setup Guide"]

    style start fill:#e1f5ff,stroke:#0288d1,stroke-width:3px
    style question fill:#fff3e0,stroke:#f57c00,stroke-width:2px
    style patternA fill:#e8f5e9,stroke:#388e3c,stroke-width:2px
    style patternB fill:#fff3e0,stroke:#f57c00,stroke-width:2px
    style patternC fill:#e3f2fd,stroke:#1976d2,stroke-width:2px
    style setupA fill:#c8e6c9,stroke:#2e7d32,stroke-width:1px
    style setupB fill:#ffe0b2,stroke:#e65100,stroke-width:1px
    style setupC fill:#bbdefb,stroke:#1565c0,stroke-width:1px
```

***

## Pattern comparison

A detailed look at the trade-offs between the three deployment models.

| Aspect          | Pattern A (Single)     | Pattern B (Centralized) | Pattern C (Distributed) |
| :-------------- | :--------------------- | :---------------------- | :---------------------- |
| **Scale**       | 1 Repository           | 2+ Repositories         | 2+ Repositories         |
| **Permissions** | Default `GITHUB_TOKEN` | Elevated PAT/App        | Default `GITHUB_TOKEN`  |
| **Management**  | Individual             | Unified Control         | Autonomous Teams        |
| **Complexity**  | Very Low               | Medium                  | Medium                  |
| **Best For**    | Standalone Projects    | Org-wide Automation     | Microservices           |

### Pattern A: Single repo

Best for standalone projects or teams just testing Simili Bot. No special permissions or organization-wide configuration is required.

[Go to Single Repo Setup](/getting-started/single-repo-setup)

### Pattern B: Centralized multi-repo

Best for organizations that want unified control over how issues are triaged and routed across all repositories. Everything is managed from one "control" repository.

[Go to Centralized Setup](/getting-started/centralized-multi-repo-setup)

### Pattern C: Distributed multi-repo

Best for large organizations with independent teams. Each team manages their own bot, but everyone benefits from a shared cross-repository knowledge base.

[Go to Distributed Setup](/getting-started/distributed-multi-repo-setup)

***

## Need more details?

<CardGroup cols={2}>
  <Card title="Patterns overview" href="/getting-started/patterns-overview" icon="diagram-project" />

  <Card title="Permission guide" href="/configuration/permissions" icon="lock" />
</CardGroup>