Admin Configuration

Configure FluidRAG via Admin UI

1. Open the Admin UI at http://localhost/config-ui
2. Navigate to the Connectors page
3. Find GitHub in the connector list and click Configure
4. Switch to the Credentials tab

Required: GitHub PAT

Enter your GitHub Personal Access Token:

Secret	Value
GITHUB_TOKEN	Your ghp_ personal access token

Optional: Sourcebot (for code search)

If you have a Sourcebot instance, enter its credentials:

Secret	Value
SOURCEBOT_HOST	Your Sourcebot API host (e.g., http://sourcebot:3000)
SOURCEBOT_API_KEY	Your Sourcebot API key

Note: SOURCEBOT_HOST and SOURCEBOT_API_KEY are secrets, not regular settings. Code search tools become available automatically once both are configured.

Organization and Filtering

Configure these in the Source Config tab:

Setting	Default	Description
github_org	generic-org	GitHub organization to scope all searches
github_ignored_repos	(empty)	Comma-separated repo names to exclude
github_ignore_patterns	(empty)	Comma-separated fnmatch patterns (e.g., *-internal,*-test)

Organization auto-detection: If you leave github_org as the placeholder (generic-org), FluidRAG will automatically detect your organization from the PAT. You only need to set it explicitly if you want to override the detected value.

Enable the GitHub Agent

The GitHub agent is enabled by default but requires GITHUB_TOKEN to be configured before it will function. After setting your token:

1. Verify the connector shows as configured on the Health page
2. If the connector shows as disabled, navigate to the Connectors page in the Admin UI and toggle GitHub to enabled

Hot reload: Credentials can be added or updated at any time without restarting FluidRAG. The connector lazily re-initializes the GitHub REST service and Sourcebot client on demand.