What exactly needs to be done and for what purposes will the work be used?
It is necessary to completely write a Telegram assistant from scratch called “Your AstroGuide” based on aiogram v3.
The goal is to create an assistant that helps users through astrology, Tarot, AI analysis of dreams, horoscopes, and reflection.
Use of any AI is allowed (not necessarily Mistral).
Any database can be chosen (SQLite, PostgreSQL, MongoDB, etc.).
Functionality to be implemented:
User registration
Select zodiac sign via keyboard
Save in database
Virtual currency — “cards”
Each user has a balance of cards
Actions deduct a certain number of cards
Ability to view balance
Daily bonus (+10–30 cards, once a day)
Referral system (user receives 25 cards for each friend who joins via their link)
Tarot spread
User writes a question
Draw 3 random cards
AI generates an explanation of the spread (short, meaningful text)
Dream interpretation
User sends their dream
AI generates a personalized interpretation of the dream
Daily horoscope
For each zodiac sign separately
Automatic distribution to users based on their sign
Questions to the astrologer
User writes a question — AI generates a warm and meaningful response
Sign compatibility
User chooses their sign and partner's sign
AI generates a description of their energetic interaction
Archetype test
5 questions for each of two people
Determining archetypes
AI generates an analysis of their “soul compatibility”
Astral habit of the day
Brief daily recommendation or habit (in the form of a phrase)
Problem analysis
User writes the situation
AI provides a deep, serious response with a final aphoristic phrase
Music test
15 questions with options
Result output (genre or style) based on answers
Structure
FSMContext is used in all scenarios
Code is divided into separate files: router, handlers, keyboards, database, states, utils
Comments in the code are mandatory
What criteria will be used to evaluate the result?
Code is fully written from scratch
All functions work stably, without errors
Integration with any AI (Mistral / OpenAI / Claude / others) works
All logic with cards is implemented
Daily automatic distribution is implemented
Code architecture is clear and easy to maintain
Project is deployed on a server (deployment assistance needed)
For clarifications — write in private messages. Deployment on the server is also part of the task.
