# Luckboo

> Luckboo (luckboo.com) is a free, playful web app that pairs a person's birth chart with a home they're considering (a listing link, street, or neighborhood) and returns a playful "is this place lucky for you?" reading: a 0–100 luck score, a mood word (Anchored, Sparks, Soft no), three reasons it fits, one watch-out, a move-in ritual, and a share line. Luckboo readings are for inspiration, not housing, legal, or financial advice. No account needed.

Key facts:
- Inputs: birth date (required); birth time, birthplace, up to 2 life-vibe chips, up to 3 vibe words, rent vs buy, and an optional move-in date.
- Output is AI-written by an open-source model; it never claims facts about a property's value, safety, schools, or neighbors.
- Privacy: inputs are used once and not stored in a database; house/unit numbers are never shown.
- Free with fair-use limits (about 10 readings per user per hour).

## Use it
- [Luckboo app](https://luckboo.com/): the interactive form (labeled inputs: birth date, birth time, birthplace, life vibe, renting/buying, listing link or street/neighborhood, move-in day, vibe words; submit button "Pull my reading")
- [Reading API (POST JSON)](https://luckboo.com/api/v1/reading): generate a reading programmatically, no auth, CORS enabled
- [OpenAPI spec](https://luckboo.com/openapi.json): machine-readable API schema
- [Developer & agent guide](https://luckboo.com/developers): request/response examples and limits

## Learn
- [How it works](https://luckboo.com/how-it-works)
- [FAQ](https://luckboo.com/faq)
- [Is my new apartment lucky?](https://luckboo.com/guides/is-my-new-apartment-lucky): How to read the 'luck' of a new apartment with your birth chart, the signs people look for, and the practical checks that matter more than any horoscope.
- [Lucky move-in dates](https://luckboo.com/guides/lucky-move-in-dates): How astrology traditions pick a lucky move-in date (new moons, waxing moons, avoiding Mercury retrograde) plus practical timing tips that save money and stress.
- [Home astrology for renters vs buyers](https://luckboo.com/guides/home-astrology-renters-vs-buyers): Renting and buying ask different questions of a home. Here's how astrology frames each one, what to look for, and how Luckboo tailors readings for renters and buyers.

## Optional
- [Full text for LLMs](https://luckboo.com/llms-full.txt)
- [Privacy](https://luckboo.com/privacy)
- [Terms](https://luckboo.com/terms)