varun86

open-gamma

An open source implementation of an AI agent that generates slides in google slides

0
0
0
public
Forked
View on GitHub

Open Gamma

A production-ready AI Chat application featuring tool usage (Google Slides, etc.), Vercel AI SDK for chat streaming, and NextAuth v5 for authentication.

Features

  • AI Chat: Powered by Vercel AI SDK (supports OpenAI, Anthropic, Google).
  • Tool Integration: Connect with external tools like Google Slides.
  • Authentication: Custom authentication flow with NextAuth sessions.
  • Database: PostgreSQL with Drizzle ORM.
  • Infrastructure: Next.js 15 (App Router), Tailwind CSS.
  • Security: Request validation, environment validation, and secure auth flows.

Tech Stack

  • Framework: Next.js 16 (App Router)
  • Language: TypeScript
  • Database: PostgreSQL
  • ORM: Drizzle ORM
  • Auth: NextAuth.js (Auth.js v5)
  • AI: Vercel AI SDK + Composio
  • Styling: Tailwind CSS
  • Validation: Zod (Env vars & Schema)
  • Linting: ESLint + Prettier

Getting Started

1. Prerequisites

  • Node.js 18+
  • PostgreSQL database (local or cloud like Neon/Supabase)

2. Environment Setup

Create a .env file in the root directory:

# Database
DATABASE_URL="postgres://user:pass@localhost:5432/open_gamma"

# NextAuth
AUTH_SECRET="your_generated_secret" # generate with `npx auth secret` or `openssl rand -base64 32`
AUTH_URL="http://localhost:3000" # Deployment URL

# Composio (Tools & Auth)
COMPOSIO_API_KEY="your_composio_api_key"
AUTH_CONFIG_ID="your_auth_config_id" # From Composio Dashboard at platform.composio.dev

# AI Providers (At least one required)
OPENAI_API_KEY="sk-..."
ANTHROPIC_API_KEY="sk-..."
GEMINI_API_KEY="sk-..."

3. Installation

npm install

4. Database Setup

Push the schema to your database (for local dev):

npm run db:push

For production migrations:

npm run db:generate
npm run db:migrate

5. Run Development Server

npm run dev

Open http://localhost:3000.

Architecture

Authentication Flow

  1. User clicks “Sign in with Composio”.
  2. App generates a unique userId and calls the Composio link API.
  3. User authenticates with the external provider (e.g., Google/GitHub).
  4. Composio redirects back to /auth/callback.
  5. App verifies the userId and creates a NextAuth session.

AI & Tools

The chat interface (app/page.tsx) uses the Vercel AI SDK useChat hook.
Tools are executed via Composio on the server (app/api/chat/route.ts).
Rate limiting is applied per user session.

Database Scripts

Drizzle commands require DATABASE_URL to be set. Either export it or prefix the command:

# Option 1: Export in shell
export DATABASE_URL="postgres://..."
npm run db:push

# Option 2: Inline
DATABASE_URL="postgres://..." npm run db:push
  • npm run db:push: Push schema changes directly (prototyping only).
  • npm run db:generate: Generate SQL migration files (production).
  • npm run db:migrate: Apply migration files to the DB.
  • npm run db:studio: Open Drizzle Studio to view data.

Deployment

  1. Build: npm run build
  2. Environment: Ensure all .env variables are set in your provider (Vercel/Railway).
  3. Database: Run npm run db:migrate during the build process or as a post-deploy step.

Contributing

  1. Fork the repository.
  2. Create a feature branch.
  3. Commit your changes.
  4. Push to the branch.
  5. Open a Pull Request.

Composio

This project uses Composio for tool integrations and authentication.

v0.3.3[beta]