Gemini Service (+ multi-provider BYOK)

Google Gemini API helpers for Yuzuup — the IDE-integrated task platform (@yuzutask-project). Used by the MCP server for AI task breakdown and related flows.

Also exports a multi-provider layer (generateText) for BYOK: Gemini (default), OpenAI, Anthropic, OpenRouter, Perplexity. See docs/developers/AI_PROVIDERS_BYOK.md.

License

Proprietary — all rights reserved. Not open source. See LICENSE.

Installation

npm install @yuzutask-project/gemini-service

Monorepo development:

npm install
npm run build

Usage (Gemini)

import { initializeGemini, generateWithGemini } from '@yuzutask-project/gemini-service';

await initializeGemini({
  apiKey: 'your-api-key',
  model: 'gemini-2.0-flash',
});

const response = await generateWithGemini({
  prompt: 'Break down this task...',
  maxTokens: 2000,
  temperature: 0.7,
});

Usage (BYOK multi-provider)

import { generateText, setMultiProviderConfig } from '@yuzutask-project/gemini-service';

setMultiProviderConfig({
  mainModel: { provider: 'anthropic', model: 'claude-sonnet-4-20250514' },
  fallback: { provider: 'openai', fallbackOnError: true },
});

const { text, provider, model } = await generateText({
  prompt: 'Break down this task...',
  role: 'main',
});

Keys resolve from config or env: GEMINI_API_KEY / GOOGLE_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY, OPENROUTER_API_KEY, PERPLEXITY_API_KEY.

Configuration

• CLI: tkl models --setup → .taskmanager/config.json
• Environment keys as above
• Google Cloud Application Default Credentials (Gemini)

Models (Gemini defaults)

• gemini-2.0-flash — default in multi-provider layer
• Legacy gemini-pro still accepted by initializeGemini