# shockbot

Self-hosted AI code review for Gitea, powered by Ollama. Tag `@shockbot` in a PR comment to trigger a review, or configure it to auto-review on every PR.

Based on [pullfrog](https://github.com/pullfrog/pullfrog) — simplified for self-hosted Gitea + Ollama setups.

## Requirements

- Gitea instance
- Ollama instance reachable from your Gitea Actions runner
- A Gitea bot account with repo read/write access

## Setup

### 1. Create a bot account

Create a Gitea account for the bot (e.g. `shockbot`) and generate an access token with `read:issue`, `write:issue`, `read:pull_request`, `write:pull_request` scopes.

### 2. Add secrets to your repo

| Secret | Description |
|--------|-------------|
| `BOT_TOKEN` | Gitea access token for the bot account |
| `OLLAMA_HOST` | URL of your Ollama instance (e.g. `http://192.168.1.10:11434`) |

### 3. Add the workflow

Create `.gitea/workflows/shockbot.yml` in the repo you want reviewed:

```yaml
name: Shockbot Review
on:
  pull_request:
    types: [opened, ready_for_review]
  issue_comment:
    types: [created]

permissions:
  contents: write
  pull-requests: write
  issues: write

jobs:
  review:
    if: |
      (github.event_name == 'pull_request' && !github.event.pull_request.draft) ||
      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@shockbot'))
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          fetch-depth: 1

      - name: Run shockbot (PR trigger)
        if: github.event_name == 'pull_request'
        uses: https://git.shockvpn.com/ShockVPN/shockbot@main
        with:
          prompt: "Review this pull request"
        env:
          BOT_TOKEN: ${{ secrets.BOT_TOKEN }}
          OLLAMA_HOST: ${{ secrets.OLLAMA_HOST }}
          GITEA_URL: https://git.shockvpn.com
          GITEA_PR_NUMBER: ${{ github.event.pull_request.number }}
          GITEA_PR_TITLE: ${{ github.event.pull_request.title }}

      - name: Run shockbot (mention trigger)
        if: github.event_name == 'issue_comment'
        uses: https://git.shockvpn.com/ShockVPN/shockbot@main
        with:
          prompt: ${{ github.event.comment.body }}
        env:
          BOT_TOKEN: ${{ secrets.BOT_TOKEN }}
          OLLAMA_HOST: ${{ secrets.OLLAMA_HOST }}
          GITEA_URL: https://git.shockvpn.com
          GITEA_PR_NUMBER: ${{ github.event.issue.number }}
```

## Configuration

Three values need to be configured — the rest come from the event context (as shown in the workflow example above) or are set automatically by Gitea Actions.

| Secret / env var | Description |
|-----------------|-------------|
| `BOT_TOKEN` | Gitea access token for the bot account |
| `OLLAMA_HOST` | URL of your Ollama instance |
| `GITEA_URL` | URL of your Gitea instance |

### Model

Defaults to `qwen3.6:35b`. Override with the `model` input:

```yaml
with:
  prompt: "Review this pull request"
  model: "llama3.1:70b"
```

## Usage

- **Auto-review on PR open** — the PR trigger fires automatically on new PRs
- **Manual trigger** — comment `@shockbot review` on any PR to trigger a review on demand
- **Custom prompt** — any comment mentioning `@shockbot` is passed as the prompt, so `@shockbot review focusing on security` works

## License

MIT. Based on [pullfrog/pullfrog](https://github.com/pullfrog/pullfrog), used under the MIT license.