Skip to main content

AI Configuration

Configure your AI provider, API key, and preferred model for Ask AI, the AI Agent, and bill summaries.

AI Settings Screen

AI settings screen

AI Configuration Settings

Open Settings → AI Configuration to set up your AI provider.

Supported Providers

YesBill supports four AI providers. You bring your own API key (except for Ollama).

ProviderWhere to Get a Key
OpenAIplatform.openai.com/api-keys
Anthropicconsole.anthropic.com/settings/keys
Google AIaistudio.google.com/apikey
OllamaNo key needed — runs models locally on your device

Provider Settings

Provider settings screen

Choose AI provider

  1. Select your AI Provider from the list.
  2. Enter your API Key (skip this step for Ollama).

Select AI model

  1. Select a Model from the dropdown (models vary by provider).
  2. Tap Save.

A green checkmark appears once your key is validated and saved.

OpenAI Models

ModelNotes
GPT-5.5Flagship model (April 2026) — recommended
GPT-5.4Advanced reasoning (March 2026)
GPT-5.2 / 5.1 / 5400,000-token context window
GPT-5.4 Mini128,000-token context, budget-friendly
GPT-5.4 Nano64,000-token context, fastest
GPT-5 Mini / NanoCompact versions of GPT-5
o1Advanced reasoning — best for complex analysis

Anthropic Models

ModelNotes
Claude Sonnet 4Best balance of speed and intelligence — recommended
Claude 3.5 HaikuFastest and most compact

Google AI Models

ModelNotes
Gemini 2.0 FlashFast multimodal model — recommended
Gemini 1.5 ProBest for complex tasks

Ollama (Local Models)

Ollama provider settings

Ollama lets you run AI models entirely on your own machine — no API key, no usage costs, complete privacy.

To use Ollama:

  1. Install Ollama on your computer and pull a model (e.g. ollama pull llama3.2)
  2. Expose Ollama via a Cloudflare Tunnel so YesBill's backend can reach it
  3. In the app, select Ollama as the provider
  4. Paste your tunnel URL in the Ollama Base URL field
  5. Tap Fetch Models — your installed models will appear
  6. Select a model and tap Save
Which model to start with?
  • Best quality: GPT-5.5 or Claude Sonnet 4
  • Best value: GPT-5.4 Nano or Gemini 2.0 Flash
  • No cost at all: Ollama with Llama 3.2 or Mistral
API key security

Your API key is stored securely on-device using Flutter Secure Storage and is sent directly to the AI provider — never to YesBill's servers.

Reasoning / Extended Thinking

Some models support Extended Thinking (also called reasoning). When enabled, the AI thinks through problems step by step before responding, which significantly improves accuracy for complex queries like multi-service bill analysis.

In Settings → AI Configuration, look for the Default Reasoning Effort selector:

Default Reasoning Effort setting

  • None — Standard response (faster, cheaper)
  • Low — Light reasoning pass
  • High — Full extended thinking (slower, more tokens)

AI Insights Toggle

You can enable or disable the AI Insights panel that appears on your Dashboard:

Enable or disable AI Insights

  1. Open Settings → AI Configuration
  2. Toggle Enable AI Insights on or off

When enabled, the dashboard shows an AI-generated summary of your spending trends, updated each time you generate bills.

See Appearance Settings to change the app theme.