firebase-ai-logic-basics
installsforks
How to install firebase-ai-logic-basics?
firebase/agent-skills/firebase-ai-logic-basics
$npx -y skills add firebase/agent-skills --skill firebase-ai-logic-basicsOfficial skill for integrating Firebase AI Logic (Gemini API) into web applications. Covers setup, multimodal inference, structured output, and security.
SKILL.md
| 1 | # Firebase AI Logic Basics |
| 2 | |
| 3 | ## Overview |
| 4 | |
| 5 | Firebase AI Logic is a product of Firebase that allows developers to add gen AI |
| 6 | to their mobile and web apps using client-side SDKs. You can call Gemini models |
| 7 | directly from your app without managing a dedicated backend. Firebase AI Logic, |
| 8 | which was previously known as "Vertex AI for Firebase", represents the evolution |
| 9 | of Google's AI integration platform for mobile and web developers. |
| 10 | |
| 11 | It supports the two Gemini API providers: |
| 12 | |
| 13 | - **Gemini Developer API**: It has a free tier ideal for prototyping, and |
| 14 | pay-as-you-go for production |
| 15 | - **Vertex AI Gemini API**: Ideal for scale with enterprise-grade production |
| 16 | readiness, requires Blaze plan |
| 17 | |
| 18 | Use the Gemini Developer API as a default, and only Vertex AI Gemini API if the |
| 19 | application requires it. |
| 20 | |
| 21 | ## Setup & Initialization |
| 22 | |
| 23 | ### Prerequisites |
| 24 | |
| 25 | - Before starting, ensure you have **Node.js 16+** and npm installed. Install |
| 26 | them if they aren’t already available. |
| 27 | - Identify the platform the user is interested in building on prior to starting: |
| 28 | Android, iOS, Flutter or Web. |
| 29 | - If their platform is unsupported, Direct the user to Firebase Docs to learn |
| 30 | how to set up AI Logic for their application (share this link with the user |
| 31 | https://firebase.google.com/docs/ai-logic/get-started) |
| 32 | |
| 33 | ### Installation |
| 34 | |
| 35 | The library is part of the standard Firebase Web SDK. |
| 36 | |
| 37 | `npm install -g firebase@latest` |
| 38 | |
| 39 | If you're in a firebase directory (with a firebase.json) the currently selected |
| 40 | project will be marked with "current" using this command: |
| 41 | |
| 42 | `npx -y firebase-tools@latest projects:list` |
| 43 | |
| 44 | Ensure there's at least one app associated with the current project |
| 45 | |
| 46 | `npx -y firebase-tools@latest apps:list` |
| 47 | |
| 48 | Initialize AI logic SDK with the init command |
| 49 | |
| 50 | `npx -y firebase-tools@latest init ailogic` |
| 51 | |
| 52 | This will automatically enable the Gemini Developer API in the Firebase console. |
| 53 | |
| 54 | More info in |
| 55 | [Firebase AI Logic Getting Started](https://firebase.google.com/docs/ai-logic/get-started.md.txt) |
| 56 | |
| 57 | ## Core Capabilities |
| 58 | |
| 59 | > [!WARNING] **CRITICAL: Use current model names:** Always check the |
| 60 | > [Firebase AI Logic Models documentation](https://firebase.google.com/docs/ai-logic/models.md.txt) |
| 61 | > for the currently supported model names. Do NOT use `gemini-2.0-pro` or |
| 62 | > `gemini-2.0-flash` or other older models that are shutdown. |
| 63 | |
| 64 | ### Text-Only Generation |
| 65 | |
| 66 | ### Multimodal (Text + Images/Audio/Video/PDF input) |
| 67 | |
| 68 | Firebase AI Logic allows Gemini models to analyze image files directly from your |
| 69 | app. This enables features like creating captions, answering questions about |
| 70 | images, detecting objects, and categorizing images. Beyond images, Gemini can |
| 71 | analyze other media types like audio, video, and PDFs by passing them as inline |
| 72 | data with their MIME type. For files larger than 20 megabytes (which can cause |
| 73 | HTTP 413 errors as inline data), store them in Cloud Storage for Firebase and |
| 74 | pass their URLs to the Gemini Developer API. |
| 75 | |
| 76 | ### Chat Session (Multi-turn) |
| 77 | |
| 78 | Maintain history automatically using `startChat`. |
| 79 | |
| 80 | ### Streaming Responses |
| 81 | |
| 82 | To improve the user experience by showing partial results as they arrive (like a |
| 83 | typing effect), use `generateContentStream` instead of `generateContent` for |
| 84 | faster display of results. |
| 85 | |
| 86 | ### Generate Images with Nano Banana |
| 87 | |
| 88 | > [!WARNING] **Use current Image model names:** Always check the |
| 89 | > [Firebase AI Logic Models documentation](https://firebase.google.com/docs/ai-logic/models.md.txt) |
| 90 | > for the currently supported image generation (Nano Banana) model names. |
| 91 | |
| 92 | - Requires an upgraded Blaze pay-as-you-go billing plan. |
| 93 | |
| 94 | ### Search Grounding with the built in googleSearch tool |
| 95 | |
| 96 | ## Supported Platforms and Frameworks |
| 97 | |
| 98 | Supported Platforms and Frameworks include Kotlin and Java for Android, Swift |
| 99 | for iOS, JavaScript for web apps, Dart for Flutter, and C Sharp for Unity. |
| 100 | |
| 101 | ## Advanced Features |
| 102 | |
| 103 | ### Structured Output (JSON) |
| 104 | |
| 105 | Enforce a specific JSON schema for the response. |
| 106 | |
| 107 | ### On-Device AI (Hybrid) |
| 108 | |
| 109 | Hybrid on-device inference for web apps, where the Firebase Javascript SDK |
| 110 | automatically checks for Gemini Nano's availability (after installation) and |
| 111 | switches between on-device or cloud-hosted prompt execution. This requires |
| 112 | specific steps to enable model usage in the Chrome browser, more info in the |
| 113 | [hybrid-on-device-inference documentation](https://firebase.google.com/docs/ai-logic/hybrid-on-device-inference.md.txt). |
| 114 | |
| 115 | ## Security & Production |
| 116 | |
| 117 | ### App Check |
| 118 | |
| 119 | > [!WARNING] **Critical Safety Requirement:** In order to use AI Logic safely, |
| 120 | > you MUST set up App Check on your app. This prevents unauthorized clients from |
| 121 | > using your API quota and accessing your backend resources. |
| 122 | |
| 123 | See |
| 124 | [App Check with reCAPTCHA Enterprise](https://firebase.google.com/docs/app-check/web/recaptcha-enterprise-provider.md.txt) |
| 125 | for setup instructions. |
| 126 | |
| 127 | ### Remote Config |
| 128 | |
| 129 | Consid |
People who liked this also viewed
6 picksType
- hyperframes-cliUse the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, SkillsJul 2026
- request-refactor-planSkills for Real Engineers. Straight from my .agents directory.SkillsJul 2026
- analyze-projectRigor Analyze / Rigor Audit read-only skill for deep learning research repositories. Use when the user wants to read and understand a repository, inspect model structure and training or inference entrSkillsMay 2026
- explore-codeRigor Improve implementation leaf skill for auditable candidate implementation in deep learning research repositories. Use when the researcher explicitly authorizes exploratory work on an isolated braSkillsMay 2026
- ubiquitous-languageSkills for Real Engineers. Straight from my .agents directory.SkillsJul 2026
- scaffold-exercisesSkills for Real Engineers. Straight from my .agents directory.SkillsJul 2026
