Data source: GitHub API
https://context.gnist.ai/rest/github/
AuthenticationAll requests require a Gnist-API-Key header (or api_key query parameter).
Free tier: 100 calls/day. Get your API key.
Tools (5)
search_reposSearch public GitHub repositories by keyword.
Returns up to 10 repositories ranked by star count.
Args:
query: Search terms (e.g. "machine learning framework", "http client").
language: Filter by programming language (e.g. "python", "typescript"). Optional.
stars_min: Minimum star count filter (e.g. 100). Optional.
Returns:
List of repositories with full_name, description, stars, forks, language,
license (SPDX id), last_pushed (ISO 8601), topics, and url.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | required | Search terms (e.g. "machine learning framework", "http client"). |
language | any | optional | Filter by programming language (e.g. "python", "typescript"). Optional. |
stars_min | any | optional | Minimum star count filter (e.g. 100). Optional. |
{
"query": "example"
}get_readmeFetch and decode the README for a GitHub repository.
Useful for understanding what a project does before recommending it.
Args:
owner: Repository owner (user or org), e.g. "fastapi".
repo: Repository name, e.g. "fastapi".
Returns:
Object with owner, repo, and content (raw README text, typically Markdown).
| Parameter | Type | Required | Description |
|---|---|---|---|
owner | string | required | Repository owner (user or org), e.g. "fastapi". |
repo | string | required | Repository name, e.g. "fastapi". |
{
"owner": "123456789",
"repo": "example"
}list_open_issuesList open issues for a public GitHub repository.
Pull requests are excluded. Returns up to 30 issues, newest first.
Args:
owner: Repository owner (user or org), e.g. "django".
repo: Repository name, e.g. "django".
labels: Filter by label names (e.g. ["bug", "help wanted"]). Optional.
Returns:
List of issues with number, title, state, author, labels, created_at,
updated_at, and url.
| Parameter | Type | Required | Description |
|---|---|---|---|
owner | string | required | Repository owner (user or org), e.g. "django". |
repo | string | required | Repository name, e.g. "django". |
labels | any | optional | Filter by label names (e.g. ["bug", "help wanted"]). Optional. |
{
"owner": "123456789",
"repo": "example"
}get_repo_statsGet metadata and statistics for a specific public GitHub repository.
Args:
owner: Repository owner (user or org), e.g. "astral-sh".
repo: Repository name, e.g. "ruff".
Returns:
Repository metadata: full_name, description, stars, forks, language,
license (SPDX id), last_pushed (ISO 8601), topics, and url.
| Parameter | Type | Required | Description |
|---|---|---|---|
owner | string | required | Repository owner (user or org), e.g. "astral-sh". |
repo | string | required | Repository name, e.g. "ruff". |
{
"owner": "123456789",
"repo": "example"
}report_feedbackReport a bug, feature request, or general feedback for this data source.
Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.
Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |
{
"feedback": "example"
}Quick Start
curl -X POST "https://context.gnist.ai/rest/github/search_repos" \
-H "Content-Type: application/json" \
-H "Gnist-API-Key: YOUR_API_KEY" \
-d '{"query": "example"}'
import httpx
resp = httpx.post(
"https://context.gnist.ai/rest/github/search_repos",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
json={
"query": "example"
},
)
print(resp.json())