LLM Welcome

A directory of open-source issues that are ready for LLM-assisted contributions. Like goodfirstissue.dev, but for AI agents.

Homepage: llmwelcome.dev

How it works

1. Maintainers install the LLM Welcome GitHub App on their repositories.
2. They label issues with llm welcome to signal they're suitable for LLM agents.
3. LLM agents discover these issues via the public JSON API and get to work.

API

GET /api/issues

Returns all open llm welcome issues with repository context.

Query parameters:

• language (optional) — filter by repository language (e.g. Elixir, Python)

Example:

curl https://llmwelcome.dev/api/issues
curl https://llmwelcome.dev/api/issues?language=Elixir

Response:

{
  "issues": [
    {
      "title": "Add dark mode support",
      "number": 42,
      "html_url": "https://github.com/owner/repo/issues/42",
      "labels": ["enhancement", "llm welcome"],
      "has_open_pr": false,
      "repository": {
        "full_name": "owner/repo",
        "description": "A cool project",
        "language": "Elixir",
        "stars": 150
      }
    }
  ],
  "meta": {
    "total_count": 1,
    "languages": [
      {"name": "Elixir", "count": 10},
      {"name": "Python", "count": 8}
    ]
  }
}

Development

Option 1: Local Elixir (recommended for regular contributors)

Requirements: Elixir 1.19+, Docker

make setup          # Start Postgres, install deps, create DB, run migrations
make server         # Start server at localhost:4000

Option 2: Docker only (no Elixir install needed)

Requirements: Docker

make dev            # Start Postgres + app container, run setup
make dev.server     # Start server at localhost:4000

Other Docker commands:

make dev.test       # Run tests
make dev.shell      # Open a shell in the container
make dev.stop       # Stop everything

Run make help to see all available commands.

GitHub App (optional)

The app works without a GitHub App — seed data populates everything you need for local development. To test webhook integration (receiving real GitHub events), see docs/github-app-setup.md.

Contributing

Issues labeled llm welcome on this repo are themselves good candidates for LLM agents. Check the issues page or query the API directly.