Helix GitHub Assistant

A Helix-powered app that enables natural language interaction with GitHub Issues. Talk to your GitHub Issues using natural language!

Quick Start

Clone the repository

git clone https://github.com/helixml/helix-github-assistant.git

cd helix-github-assistant

Installation

Prerequisites

• GitHub Account
• Helix Account (sign up at app.tryhelix.ai)
• Terminal/Command Line access

Access Tokens Setup

GitHub Token:

1. Go to GitHub.com → Settings → Developer Settings
2. Select "Personal Access Tokens" → "Tokens (classic)"
3. Generate new token with 'repo' permissions
4. Copy and save the token

Helix API Key:

1. Log into app.tryhelix.ai
2. Click on the three dots beside your name
3. Click on Account & API
4. Copy Helix API Key

Configuration

Environment Setup

Set environment variables

export GITHUB_OWNER=your_github_username
export GITHUB_API_TOKEN=your_github_token
export HELIX_API_KEY=your_helix_api_key

Verify they're set

echo $GITHUB_OWNER
echo $GITHUB_API_TOKEN
echo $HELIX_API_KEY

Deploy

./deploy.sh

Assistant Configuration

Create a helix.yaml file. Copy and paste configuration:

apiVersion: app.aispec.org/v1alpha1
kind: AIApp
metadata:
  name: github-issues
spec:
  assistants:
    - model: llama3.1:8b-instruct-q8_0
      type: text
      system_prompt: |
        You are a GitHub Issues expert. Present issues clearly and include:
        * Issue title and number
        * Current status (open/closed)
        * Assignees and labels
      apis:
        - name: GitHub Issues API
          description: List repository issues
          url: https://api.github.com/repos/${GITHUB_OWNER}/${repo}/issues
          headers:
            Authorization: Bearer ${GITHUB_API_TOKEN}
            Accept: application/vnd.github.v3+json
          schema: |-
            openapi: 3.0.0
            info:
              title: GitHub Issues API
              description: List repository issues
              version: "1.0.0"
            servers:
              - url: https://api.github.com
            paths:
              /repos/{owner}/{repo}/issues:
                get:
                  operationId: listIssues
                  parameters:
                    - name: owner
                      in: path
                      required: true
                      schema:
                        type: string
                    - name: repo
                      in: path
                      required: true
                      schema:
                        type: string
                    - name: state
                      in: query
                      schema:
                        type: string
                        enum: [open, closed, all]
                  responses:
                    '200':
                      description: List of issues

Testing Your Setup

Test configuration

helix test -f helix.yaml

Step 7: Try It Out

1. Go to app.tryhelix.ai
2. Find your GitHub Issues assistant in Apps
3. Click launch
4. Try these queries:
   • "Show me open issues in helixml/helix repository"
   • "List closed issues from last week"
   • "Show issues labeled bug"

Contributing

We welcome contributions! Here's how:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Troubleshooting

If you encounter issues:

1. Check environment variables are set correctly
2. Verify GitHub token has 'repo' access
3. Make sure repository names are correct
4. Check Helix API key is valid

License

Apache 2.0 - See LICENSE for details.