Skip to main content

Working with System AI

OneDev can use a system-level lite AI model to assist with quick, lightweight operations throughout the UI. Unlike AI users, which act as virtual collaborators you can work with on your projects, the lite model runs in the background to improve experience of some OneDev operations, such as query composition, code navigating, issue branch name generation, or pull request title/description composition.

This tutorial explains how to configure the lite AI model and where it helps in OneDev.

Configure the Lite AI Model​

An administrator configures the lite model under Administration → AI Settings → Lite Model:

lite ai model

Specify an OpenAI-compatible API endpoint and, if required, an API key. OneDev uses the chat completions API and requires the endpoint to support HTTP/2 connections.

Choose a fast, cost-effective model suited for short, focused tasks. Models such as Google/gemini-2.5-flash and OpenAI/gpt-4.1-mini work well.

Once configured, OneDev uses the lite model automatically for the features below. No per-user setup is required.

Natural Language Queries​

Many query boxes in OneDev accept structured query syntax. With the lite model configured, you can describe what you want in plain language instead. Press Tab to have OneDev translate your description into a structured query:

natural language query

This works across query fields for issues, pull requests, commits, builds, projects, agents, artifact packs, and workspaces.

Accurate Symbol Navigation​

When a symbol name has multiple definitions, OneDev lists every match. The lite model marks the most likely definition so you can jump to the right place faster, in both source and diff views:

accurate symbol navigation

Without the lite model, you still see all matches, but none are pre-selected.

Issue Branch Name Generation​

OneDev generates issue branch names as [prefix/]issue-<number>-<slug> when you click Create Branch on an issue, assign the issue to an AI user, or run a CI/CD Create Branch step with Use generated branch name.

Without the lite model, the slug is derived by normalizing the title, with truncation on long titles. With the lite model, it produces a shorter, more readable slug and translates non-English titles first.

generated issue branch

You can set an optional Branch Prefix in project issue settings (for example feature).

Pull Request Title and Description Suggestions​

When you open a pull request that spans multiple commits, OneDev uses the lite model to suggest a title and description based on the commit messages:

pull request title and description suggestion

See Also​

For AI user collaboration—issue/PR assignment, code review, CI/CD error fix, merge conflict resolve, and more—see Working with AI User.