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

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages