AI Settings

Repository content ingestion in Venue.sh indexes source code from your connected Git repositories so your organization can search repository content, use general AI features such as summaries, and discover Skills from SKILL.md files.

Ingestion runs in the background after repositories are imported into the catalog. You configure ingestion and general AI usage under Settings > AI Settings.

Key Capabilities

• Repository indexing - Index files from connected repositories so your organization can search their contents.
• General AI usage - Generate structured summaries (purpose, technologies, architecture, and key components) for catalog entities linked to repositories, plus related AI suggestions.
• Assistant integration - Let the Assistant answer repository summary and code questions using ingested content.
• Skills discovery - Catalog agent skills from SKILL.md files during ingestion. See Skills.

How Ingestion Works

When Repository Ingestion is enabled for your organization, Venue.sh starts an ingestion job automatically in these situations:

• You import repositories into the catalog.
• A catalog entity with an associated repository is created or updated.

Each job indexes the repository's source content. When the job completes, search and summary features use the latest indexed snapshot. If ingestion is disabled, new jobs are not started.

Prerequisites

• A Git connection and imported repositories with valid source locations in the catalog.
• Repository Ingestion enabled under Settings > AI Settings.
• For summaries and related AI features, General AI Usage must also be enabled on the same page.

Configuring AI Settings (Admin)

You manage this page from Settings > AI Settings. You need Assistant settings Read permission to view it and Update permission to change it.

1. Open Settings and select AI Settings.
2. Configure General AI Usage and Repository Ingestion as described below.
3. Click Save Configuration.

Changes apply to future ingestion jobs and summary generation requests.

General AI Usage

When Repository Ingestion is enabled, turn on General AI Usage so Venue.sh can generate summaries, suggestions, and related AI output for your organization. The switch stays off until ingestion is enabled.

By default, Venue.sh creates summaries automatically after ingestion completes.

Under Advanced, enable Use Assistant Configuration and select an Assistant Configuration and Model for repository summaries. You must have at least one Assistant configuration with allowed models before using this option. See Setting Up the Assistant (Admin).

Repository Ingestion

Use the Repository Ingestion switch to enable or disable indexing for your organization. When you disable ingestion, General AI Usage is turned off as well.

Choose an embedding mode:

Mode	Description
Managed Ingestion	Venue.sh handles repository ingestion and keeps the underlying embedding configuration out of the way. Recommended for most organizations.
Bring Your Own Model	Connect a self-hosted Ollama embedding endpoint. Provide the Ollama Base URL, Model Name, and an API Key if your endpoint requires authentication.

Other embedding options

If you want to use a different embedding provider such as Voyage AI or Cohere, contact the Venue.sh team.

Viewing Repository Summaries

When a summary exists for a catalog entity linked to a repository, a Summary tab appears on the entity detail page (after Overview).

The summary includes:

• Purpose - What the repository or service does.
• Technologies - Languages, frameworks, or tools detected in the codebase.
• Architecture - High-level structural overview.
• Key components - Notable modules or areas of the codebase.
• Conventions - Coding or repository conventions when available.

If no Summary tab appears, the repository may not be ingested yet, General AI Usage may be disabled, or a summary has not been generated for that repository.

Using Ingestion with the Assistant

When ingestion is enabled and a repository has been indexed, the Assistant can help with repository-aware questions. For example:

• "Give me a summary of the checkout-service repository."
• "How is authentication implemented in the payments-service repo?"
• "Where is the database connection configured in frontend-app?"

The Assistant resolves repositories by name, URL, or catalog context. You do not need to provide internal repository IDs.

Repository search respects team ownership. You can only search repositories your teams own in the catalog. If you see no results or an access error, confirm your team membership and the entity's owner metadata.

Skills Discovery

During ingestion, Venue.sh scans repository files for SKILL.md definitions and updates the Skills catalog. New or updated skills appear after the next successful ingestion run for that repository. Removed SKILL.md files are dropped from the catalog on a subsequent run.

Permissions

Action	Who can do it
View AI Settings	Users with Assistant settings Read permission (typically Admins)
Update ingestion and general AI usage	Users with Assistant settings Update permission (Admins)
View repository summaries in the catalog	Users with catalog Read access to the entity
Search ingested repository content via the Assistant	Users who belong to a team that owns the repository

Ingestion jobs triggered by import or entity updates are recorded in the Activity Log.

Troubleshooting

Situation	What to do
Cannot see AI Settings	Your role may not include Assistant settings Read permission. Contact your Venue administrator.
Ingestion never runs	Confirm Repository Ingestion is enabled and repositories are imported with a valid source location annotation.
No Summary tab on an entity	Enable General AI Usage, wait for ingestion to complete, and confirm the entity is linked to a repository.
Assistant cannot answer code questions	The repository may not be ingested yet, ingestion may be disabled, or you may not have access to that repository's owning team.
Skills not appearing	Wait for the next ingestion run after committing SKILL.md files. Confirm the repository is connected and ingestion is enabled. See Skills.
Ollama mode fails	Verify the base URL, model name, and API key. Ensure Venue.sh can reach your Ollama endpoint from its environment.

See Also

• Importing Repositories - Connect and import repositories into the catalog.
• Assistant - Ask questions about catalog, documentation, and ingested repositories.
• Skills - Browse agent skills discovered during ingestion.
• Settings - Account and organization configuration, including AI Settings.
• Activity Log - Audit trail for ingestion events.