Skip to main content
Get started with Gima AI Chatbot and have a working AI assistant in minutes.

​
Prerequisites

Before you begin, make sure you have:
  • Node.js 20+ installed on your system
  • A package manager (npm, yarn, or pnpm)
  • API keys for:

​
Quick Start

1

Clone and Install

Clone the repository and install dependencies:
git clone https://github.com/jose-miserol/gima-ai-chatbot.git
cd gima-ai-chatbot
npm install
2

Configure Environment

Create your environment file and add your API keys:
cp .env.example .env.local
Edit .env.local and add your keys:
.env.local
GROQ_API_KEY=gsk_your_groq_key_here
GOOGLE_GENERATIVE_AI_API_KEY=AIzaYour_gemini_key_here
NODE_ENV=development
Make sure your .env.local file is saved with UTF-8 encoding to avoid validation errors.
3

Start the Development Server

Run the development server:
npm run dev
4

Open in Browser

Open http://localhost:3000 in your browser and start chatting!Try these example queries:
  • “Muéstrame los equipos de aire acondicionado”
  • “¿Cuáles son los mantenimientos pendientes?”
  • “Listar repuestos con bajo inventario”

​
Get Your API Keys

GROQ API Key

Sign up for a free GROQ account and generate your API key for LLaMA model access

Google Gemini Key

Get your Google AI Studio API key for Gemini vision and voice capabilities

​
What’s Next?

Now that you have Gima running, explore its powerful features:

Voice Commands

Create work orders using natural voice commands

Image Analysis

Analyze equipment parts with AI-powered computer vision

PDF Processing

Extract and analyze maintenance manuals

AI Tools

Generate checklists, summaries, and closeout notes

​
Common First-Time Issues

This usually means your .env.local file is not being read correctly. Make sure:
  • The file is named .env.local (not .env)
  • It’s in the root directory
  • It’s saved with UTF-8 encoding (not UTF-16)
On Windows, you can convert the encoding with PowerShell:
$content = Get-Content .env.local -Raw -Encoding Unicode
[System.IO.File]::WriteAllText((Resolve-Path .env.local), $content, [System.Text.UTF8Encoding]::new($false))
Verify your API keys:
  • GROQ keys must start with gsk_
  • Google Gemini keys must start with AIza
  • Keys should have no spaces or quotes around them
Either stop the process using port 3000 or use a different port:
PORT=3001 npm run dev

​
Try Advanced Features

Enable optional features by setting environment variables:
NEXT_PUBLIC_ENABLE_CHAT_PERSISTENCE=true
NEXT_PUBLIC_FEATURE_VOICE_COMMANDS=true
NEXT_PUBLIC_FEATURE_PDF_READER=true
See the Configuration Guide for all available options.

​
Need More Help?

Installation Guide

Detailed setup instructions and system requirements

Configuration

Complete environment variable reference

Build docs developers (and LLMs) love

Get started for freeTalk to us