AI

Support Center

How can we help you?

Find answers to common questions, get troubleshooting help, or contact our support team.

📚

Documentation

Complete guides and API reference to get you started quickly.

Browse Docs →
🎮

Playground

Try FreeAI interactively to understand how it works.

Try Now →
💬

Contact Support

Get direct help from our support team for technical issues.

Contact Us →

Frequently Asked Questions

Getting Started

How do I get started with FreeAI?

Start by following our Quick Start Guide. You can have FreeAI running in under 5 minutes with just Node.js installed.

Do I need API keys to use FreeAI?

No! FreeAI works without any API keys using browser automation as a fallback. However, adding API keys for Gemini or Groq will improve performance and reliability.

Technical Issues

Why is my browser automation failing?

Common causes include websites with strong anti-bot protection, network issues, or insufficient system resources. Try enabling stealth mode or switching to direct API calls if available.

How do I handle rate limiting?

Implement exponential backoff in your requests and respect the rate limits for each provider. Consider upgrading to a higher plan for increased limits.

Puppeteer installation is failing. What should I do?

Try running npm install --force or use the PUPPETEER_SKIP_CHROMIUM_DOWNLOAD environment variable and install Chromium separately.

AI Providers

Which AI providers are supported?

FreeAI supports Google Gemini (API), Groq (API), and ChatGPT (browser automation). More providers are being added regularly.

How does provider fallback work?

If your primary provider fails, FreeAI automatically tries alternative providers in order of availability and reliability until one succeeds.

Deployment

Can I deploy FreeAI on Vercel?

Yes! FreeAI is optimized for Vercel deployment with proper Next.js configuration and serverless Chromium support.

What about other hosting platforms?

FreeAI works on any Node.js hosting platform including AWS Lambda, Google Cloud Functions, Netlify, and traditional VPS servers.

Billing & Plans

Is FreeAI really free to use?

Yes! The core FreeAI is open source and free to use. Our hosted service offers additional features and support with free and paid tiers.

How do I upgrade my plan?

Visit our pricing pageto compare plans and upgrade. Changes take effect immediately.

Common Issues & Solutions

Installation Issues

Node.js Version

Ensure you're using Node.js 18 or higher. Use node --version to check.

Permission Errors

On Linux/Mac, you might need to run sudo npm install or fix npm permissions.

Network Issues

If npm install fails, try using a different registry: npm install --registry https://registry.npmmirror.com

Runtime Errors

Browser Launch Failed

Install system dependencies: sudo apt-get install -y libgbm-dev on Ubuntu.

Memory Issues

Increase memory limits: NODE_OPTIONS="--max-old-space-size=4096"

Timeout Errors

Increase timeout values in your requests or check network connectivity.

API Issues

Invalid API Response

Check your API keys are valid and have sufficient quota. Verify request format matches our documentation.

Rate Limited

Implement exponential backoff or upgrade your plan for higher rate limits.

CORS Errors

Use server-side requests only. FreeAI APIs don't support direct browser calls due to CORS.

Performance Issues

Slow Responses

Enable API keys for faster direct provider access instead of browser automation.

High Memory Usage

Close browser instances properly and avoid keeping too many pages open simultaneously.

Cold Starts

Serverless cold starts are normal. Consider keeping functions warm or using direct API calls.

Still need help?

Can't find what you're looking for? Our support team is here to help.

Average response time: 2-4 hours • Available 24/7 for Enterprise customers