Skip to content

jacobschwantes/eight-ball-api

Repository files navigation

Frame

A modern Magic 8-Ball API built with Next.js that provides fortune-telling responses to questions. The API offers various endpoints for random, biased, and sentiment-based responses.

Features

  • Random fortune responses (classic 8-ball experience)
  • Sentiment analysis of questions
  • Biased responses based on question sentiment
  • "Lucky" mode to influence response bias
  • Multi-language support
  • Edge runtime for optimal performance

Getting Started

  1. Clone the repository:
git clone https://github.com/jacobschwantes/eight-ball-api.git
cd eight-ball-api
  1. Install dependencies:
npm install
  1. Run the development server:
npm run dev
  1. Open http://localhost:3000 to see the application

Technology Stack

  • Next.js - React framework with API routes
  • Sentiment - Sentiment analysis library
  • Zod - TypeScript-first schema validation
  • Tailwind CSS - Utility-first CSS framework
  • TypeScript - Type safety and developer experience

License

This project is open source and available under the MIT license.

About

Fortune-telling API powered by sentiment analysis

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors