Skip to content

ByronLi8565/cf_ai_factoids

Repository files navigation

Factoids powered by Cloudflare

Take advantage of Cloudflare Workers, Durable Objects, and AI to auto-generate facts useful for a variety of guessing games. Live-edit a table along with AI, and view your cards rendered in real-time. State is persisted in a durable object.

Deployed at: https://cf-ai-factoids.byronli8565.workers.dev/

Instructions for running locally:

Prerequisites

  • Bun installed
  • Cloudflare account with Workers AI access

Setup

  1. Clone and install dependencies:

    git clone <repository-url>
    cd cf-ai-factoids
    bun install
  2. Configure Cloudflare:

    # Login to Cloudflare
    bunx wrangler login
  3. Start development server:

    bun run dev

    The app will be available at http://localhost:8787

Available Commands

  • bun run dev - Start local development server
  • bun run build - Build for production
  • bun run deploy - Deploy to Cloudflare Workers
  • bun test - Run test suite

Configuration

The application is configured via wrangler.jsonc and requires:

  • AI binding: Workers AI access for generating factoid cards
  • Model options include DeepSeek R1, Llama 3.3, Llama 3.1 Fast, Mistral Small, Gemma 3, and QwQ

About

Generate flashcards for charades, powered by Workers AI!

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors