🌌 Gemini Pool (2026 Edition)

The ultimate, all-in-one Gemini API wrapper for developers. Stop juggling multiple SDKs and complex configurations. Gemini Pool provides a premium, production-grade intelligence layer that makes Google's most powerful AI models (2.5 & 3.1) effortless to orchestrate.

✨ Features

• 🚀 One-Line AI: gemini.ask('Hello!') - it's that simple.
• 🧠 2026 Models: Native support for Gemini 2.5 (Stable) and Gemini 3.1 (Preview).
• 🛡️ Safety Presets: Stop configuring arrays. Use 'STRICT', 'BALANCED', or 'NONE'.
• 🖼️ Multi-Modal Magic: Pass local file paths, URIs, or base64 directly to the media property.
• 🏗️ Automated JSON: Pass a schema and get back a pre-parsed data object. No more JSON.parse().
• 🔍 Deep Grounding: Built-in Google Search, Google Maps, and Dynamic Retrieval thresholds.
• 🤖 Power Tools: Integrated support for Computer Use, MCP (Model Context Protocol), and File Search.
• 💬 Real-time Live: WebSocket-based multimodal sessions for audio/video/text interaction.
• 📈 Benchmarking: Built-in tools to compare model performance (Latency vs. Accuracy).

📦 Installation

npm install gemini-pool

🛠️ Quick Start

1. Initialize the Client

You can pass your API key directly or set the GEMINI_API_KEY environment variable.

import { Gemini } from 'gemini-pool';

// Method A: Pass directly
const gemini = new Gemini('YOUR_API_KEY');

// Method B: Uses process.env.GEMINI_API_KEY
const gemini = new Gemini(); 

2. Basic Text Generation

const res = await gemini.ask('What is the future of AI?');
console.log(res.text);

Multi-Modal & Safety Presets

const res = await gemini.ask('Analyze this screenshot', {
  media: './screenshot.png',      // Automatically handles local path, detects MIME
  safetySettings: 'STRICT'        // One-word safety configuration
});

Automated Structured Data

const city = await gemini.ask('Tell me about Paris', {
  schema: { 
    type: 'object', 
    properties: { 
      population: { type: 'number' } 
    } 
  }
});

// Access parsed data directly!
console.log(city.data.population); 

🧠 Advanced Capabilities

Thinking & Reasoning (Gemini 2.5+)

const math = await gemini.think('Solve for X: 2x + 5 = 15', {
  includeThoughts: true 
});
console.log(math.thoughts); // View the model's internal reasoning

Context Caching (Reduce Cost)

const cache = await gemini.caching.create({
  model: 'gemini-2.5-pro',
  contents: [{ role: 'user', parts: [{ text: '...long document...' }] }],
  ttlSeconds: 3600
});

// Use the cache in subsequent requests
await gemini.ask('Summarize the document', { cachedContent: cache });

Live Multimodal (WebSockets)

const session = gemini.live;
session.on('text', (text) => console.log('Live Response:', text));

await session.connect();
session.sendText('Hello, Gemini!');

📊 Token Management

Stay within budget with built-in token counting before you send the request.

const { totalTokens } = await gemini.countTokens('Analyzing a massive prompt...', {
  media: './large-image.jpg'
});
console.log(`Cost Estimate: ${totalTokens} tokens`);

🏆 Quality Standards

• 100/100 Quality Score: Zero lint warnings, zero build errors.
• Production Ready: Built with robust error handling and ESM support.
• Modern Stack: Optimized for Node.js 20+ and TypeScript 5+.

📄 License

MIT © Antigravity & Monarch Labs Inc.