Github

Connect your Github data to Airweave

Overview

The Github connector allows you to sync data from Github into Airweave, making it available for search and retrieval by your agents.

GitHub source implementation.

Explore the Github connector implementation

This connector uses a custom authentication configuration class: GitHubAuthConfig.

Authentication Configuration

GitHub authentication credentials schema.

personal_access_token

strRequired

GitHub Personal Access Token with repo scope

repo_name

strRequired

Repository to sync in owner/repo format (e.g., ‘airweave-ai/airweave’)

The following data models are available for this connector:

Schema for GitHub directory entity.

Field	Type	Description
path	str	Path of the directory within the repository
repo_name	str	Name of the repository containing this directory
repo_owner	str	Owner of the repository

Schema for a GitHub repository.

Field	Type	Description
name	Optional[str]	Name of the repository.
full_name	Optional[str]	Full name (including owner) of the repo.
owner_login	Optional[str]	Login/username of the repository owner.
private	bool	Whether the repository is private.
description	Optional[str]	Short description of the repository.
fork	bool	Whether this repository is a fork.
created_at	Optional[datetime]	When the repository was created.
updated_at	Optional[datetime]	When the repository was last updated.
pushed_at	Optional[datetime]	When the repository was last pushed.
homepage	Optional[str]	Homepage URL for the repository.
size	Optional[int]	Size of the repository (in kilobytes).
stargazers_count	int	Number of stars on this repository.
watchers_count	int	Number of people watching this repository.
language	Optional[str]	Primary language of the repository.
forks_count	int	Number of forks for this repository.
open_issues_count	int	Number of open issues on this repository.
topics	List[str]	Topics/tags applied to this repo.
default_branch	Optional[str]	Default branch name of the repository.
archived	bool	Whether the repository is archived.
disabled	bool	Whether the repository is disabled in GitHub.

Schema for a GitHub repository’s content (file, directory, submodule, etc.).

Field	Type	Description
repo_full_name	Optional[str]	Full name of the parent repository.
path	Optional[str]	Path of the file or directory within the repo.
sha	Optional[str]	SHA identifier for this content item.
item_type	Optional[str]	Type of content. Typically ‘file’, ‘dir’, ‘submodule’, or ‘symlink’.
size	Optional[int]	Size of the content (in bytes).
html_url	Optional[str]	HTML URL for viewing this content on GitHub.
download_url	Optional[str]	Direct download URL if applicable.
content	Optional[str]	File content (base64-encoded) if retrieved via ‘mediaType=raw’ or similar.
encoding	Optional[str]	Indicates the encoding of the content (e.g., ‘base64’).