Skip to content

Carsten17/fortune-cookie-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ₯  Fortune Cookie API

A playful API built with FastAPI that generates random fortunes with funny, motivational, or startup-themed twists. Perfect for demos, side projects, or just a laugh.

πŸš€ Features

Generates random fortune cookie messages

Supports different vibes: funny, motivational, startup-themed

Free and Pro endpoints

Built with FastAPI and Uvicorn

Live demo running on Render

πŸ“¦ Installation

Clone the repo: git clone https://github.com/Carsten17/fortune-cookie-api.git

cd fortune-cookie-api

Install dependencies: pip install -r requirements.txt

Run the app locally: uvicorn app:app --reload

πŸ”‘ Endpoints

GET / β†’ Root endpoint, returns a welcome message

GET /hello/{name} β†’ Say hello with your name

POST /fortune β†’ Generate a fortune cookie message

POST /fortune/pro β†’ Generate multiple themed fortunes (Pro mode, requires API key)

πŸ›  Example Request

POST /fortune { "name": "Carsten", "vibe": "funny", "topic": "ai" }

Example Response: { "fortune": "Carsten, [ai] Even robots need coffee before solving bugs." }

πŸ’‘ Use Cases

Add humor to your app or dashboard

Generate demo content for presentations

Show off API integrations in a fun way

πŸ“œ License

MIT License. Free to use, share, and modify.

About

Funny Fortune Cookie API built with FastAPI

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages