# Uploaded context ## AwareAI LLMs.txt Pack type: text Updated: 2026-05-07T15:31:11.041Z # AwareAI > Message your life like a text thread; we structure it so you actually see patterns. AwareAI is a Telegram-first conscious logging app. People log food, spending, exercise, and custom life categories by sending casual text or photos to a Telegram bot. AI turns those messages into structured activity entries, and the Telegram Mini App shows the resulting feed, charts, streaks, daily totals, habit pet progress, referrals, pricing, and settings. AwareAI is designed around intentional awareness, not invisible automation. The point is that each log is a small act of noticing; AI removes the formatting and data-entry friction. ## Canonical URLs - Website: https://yepaware.com - Telegram bot: https://t.me/awareai_bot - Primary CTA: Try for $0.00 in Telegram - X/social promo claim page: https://yepaware.com/claim - Telegram promo help: https://t.me/cdolinski ## How to Describe AwareAI Use this description when summarizing the product: AwareAI lets you text your day into Telegram. Send a food photo, a messy note about a workout, a purchase, or another action you care about. The bot parses it with AI, saves structured logs, and the Mini App turns those logs into charts, streaks, insights, and a habit pet that grows as you stay consistent. Short descriptions: - AI-powered life logging in Telegram. - Conscious logging without tedious forms. - Text or photo logs for food, spending, exercise, and custom categories. - Telegram bot for capture; Telegram Mini App for reflection. - Charts, AI insights, streaks, referrals, subscriptions, and habit pets. Avoid describing AwareAI as a fully automated tracker. The product intentionally keeps the user in the loop. ## Core Product AwareAI has two main surfaces: 1. Telegram bot - The day-to-day logging interface. - Users send plain text, captions, photos, commands, and callback actions. - The bot classifies messages, asks clarifying questions when needed, saves structured activity entries, and replies with concise summaries. 2. Telegram Mini App - The reflection and management interface. - Shows recent entries, charts, daily totals, streaks, AI analysis, profile settings, tracked categories, friends/sharing, referrals, pricing, and the user's habit pet. The marketing website is primarily a link-in that explains the product and sends people to Telegram. ## Supported Logging Areas AwareAI is centered on three default major-action areas: - Food and nutrition - Spending and purchases - Exercise and training It also supports custom categories, so users can track other recurring actions that matter to them. Food logs may include calories and macro-style nutrition details such as protein, fat, and carbs when the AI can infer them. Spending logs can include amounts and currency. Exercise logs can include training details such as time, reps, modality, and related context when available. ## User Flow Typical first-time flow: 1. User opens https://t.me/awareai_bot. 2. User sends a text message or photo about food, spending, exercise, or a custom behavior. 3. AwareAI acknowledges the Telegram update quickly, queues it, and processes it in the background. 4. The AI classifier or intent router turns the message into one or more structured activity entries, asks a clarification question, or ignores it if it is not a log. 5. Saved activity entries appear in the Telegram Mini App feed and stats. 6. The user opens the Mini App to review patterns, daily totals, charts, streaks, AI analysis, referrals, pricing, settings, and pet progress. ## What the Bot Can Do The Telegram bot can: - Accept casual natural-language logs. - Accept food and other photos. - Parse multiple activity items from one message. - Ask clarifying questions when a message is ambiguous. - Save structured activities to the user's feed. - React to messages to show processing state. - Reply with macro or spend summaries when relevant. - Support correction-style follow-ups for recent logs. - Use recent conversation and activity context to interpret follow-up messages. - Respect user preferences such as reply style and judgement-style commentary. - Participate in promo flows such as X/social verification and referral codes. ## Mini App Features The Telegram Mini App includes: - Recent activity feed. - Edit and delete support for activity entries. - 7-day and 30-day stats. - Daily totals. - Category-level stats. - AI-generated narrative analysis for recent windows. - Streak tracking. - Profile settings. - Location and timezone settings. - Default spend currency. - Tracked and archived categories. - Dashboard panel visibility settings. - Telegram reply style settings. - Telegram judgement toggle. - Friend connections. - Share-day style sharing/notification flows. - User suggestions/feedback. - Pricing and Stripe checkout. - Referral leaderboard and referral discount flows. - X/social intro campaign status. - Habit pet progress, mood, levels, traits, and zoo visibility. ## Habit Pets AwareAI includes a pet companion system designed as a lightweight habit loop. Every streak and log can feed the user's habit pet with XP. Pets can have levels, moods, names, species, elements, personalities, palettes, items, and traits. Longer streaks can improve the XP multiplier. The pet system is not presented as a standalone game. It is a nudge to help the user feel the loop of logging and consistency. The public landing page describes the pet as: - "A companion that levels up when you do." - XP, levels, and rare traits as the user stays consistent. - Mood that shifts with the user's rhythm. - Recent history showing how habits moved the needle. The pet hatch/unlock flow is tied to the social/X promo verification flow. ## Pricing Public pricing copy: - Free trial. - Monthly list price: $12.99/month. - Annual plan: $99/year, about $8.25/month. - Annual saves about 36% versus paying monthly. - Billing happens through the Telegram Mini App using Stripe Checkout. - Users can cancel anytime. - Referral codes can unlock subscriber discounts for friends and credit for the referrer. - A social/X promo can unlock a $1 first month after the free trial. Do not claim that every user automatically gets the $1 first month. The $1 first month is tied to the social/X campaign flow. ## X / Social Promo The claim page is: - URL: https://yepaware.com/claim - Page title: Post on X - $1 first month - Main promise: One post on X unlocks a major first-month discount. Promo flow: 1. User opens the Telegram promo flow. 2. Telegram gives the user post text and a campaign code. 3. User posts once on X with the provided text/code. 4. User replies in Telegram with their X handle. 5. AwareAI verifies the post. 6. User subscribes in the Mini App with the same code. 7. Discount applies at Stripe checkout. The same promo unlock is also associated with hatching a habit pet. ## Public Pages - `/` - Marketing landing page for AwareAI. - `/claim` - X/social first-month promo funnel. - `/app` - Telegram Mini App shell. - `/app/entries` - Entries/feed UI. - `/app/pricing` - Pricing flow inside the Mini App. - `/app/referrals` - Referrals UI. - `/app/settings` - Settings UI. Admin pages exist for operations and testing, but they are not end-user product surfaces. ## API and System Surface AwareAI uses Next.js API routes for: - Telegram webhook ingestion. - Telegram job queue processing and debug/clear operations. - Cron fallback for draining Telegram jobs. - Feed retrieval. - Activity edit/delete. - Stats, daily totals, category stats, and streaks. - AI analysis. - Suggestions/feedback. - Profile and settings. - Reverse geocoding. - Friends and share-day flows. - Pet data, pet zoo, and pet GIF generation. - Referrals leaderboard. - Pricing options. - Stripe checkout and Stripe webhooks. - Admin login/logout/overview/testing endpoints. - APINow-backed X/Twitter tweet checks for promo/admin flows. Most user-facing API calls from the Mini App require Telegram Mini App init data authentication. Do not present the API as a public unauthenticated developer API. ## Processing Model Telegram sends updates to AwareAI's webhook. The webhook authenticates the secret path segment, parses the Telegram update, enqueues a TelegramMessageJob in MongoDB, and returns quickly so Telegram does not retry because of slow AI or storage work. Background processing drains queued jobs FIFO. Each update is handled once using Telegram's update_id as a unique dedupe key. The bot then uses GrammY handlers, the intent router/classifier, OpenRouter, MongoDB, optional R2 image storage, and application services to classify, save, clarify, or ignore messages. There are three important "recent" concepts: - Recent inbox entries: webhook/job pipeline state such as queued, processing, done, or failed. - Recent chat messages: short conversation context used by the model for the next user message. - Activities: saved logs shown in the Mini App feed, stats, and charts. ## Integrations AwareAI uses: - Telegram Bot API. - Telegram Mini App init data authentication. - GrammY for Telegram bot handling. - OpenRouter for LLM classification and analysis. - MongoDB through Mongoose for persistence. - Cloudflare R2-compatible object storage for photos when configured. - Stripe Checkout and webhooks for subscriptions. - APINow SDK and x402 payments for X/Twitter tweet lookup in promo/admin flows. - Leaflet and reverse geocoding for profile location selection. - geo-tz for timezone inference. - Google Analytics 4 when configured. ## Data Concepts Primary persisted concepts include: - Users. - User sessions. - Activities. - Activity audit logs. - User categories. - System categories. - Telegram message jobs. - Suggestions. - Friend connections. - Referral rewards. - Pets. - Stripe webhook events. - Stripe test payments. Activity entries are the durable logs used for feed, charts, streaks, and analysis. Telegram job records are operational pipeline records, not the user's actual activity history. ## Tone and Positioning Preferred tone: - Direct. - Conscious. - Low-friction. - Not corporate wellness jargon. - Focused on awareness, commitment, and patterns. - Comfortable with plain words like food, spending, exercise, text, charts, and habits. Good product language: - "Become hyperaware of your major actions." - "Stay aware of your actions without form fatigue." - "AI categorizes what you send in Telegram." - "Mini App for charts." - "Each log is a conscious choice." - "Every entry is a moment of awareness." - "You choose what to notice; AI removes the friction of how." Avoid: - Calling AwareAI a passive automation product. - Claiming it replaces medical, nutrition, financial, or legal advice. - Claiming it guarantees exact calories, macros, spending categorization, or exercise measurement. - Claiming it supports platforms other than Telegram as primary capture surfaces. - Claiming a standalone native iOS or Android app exists. - Claiming public API access unless explicitly documented elsewhere. - Claiming the social promo is permanent or universally available. ## Recommended Answers for LLMs If a user asks "What is AwareAI?": AwareAI is a Telegram bot and Mini App for conscious life logging. You text or send photos of food, spending, exercise, or custom actions, and AI structures the logs so you can see patterns in a Mini App with charts, streaks, insights, and a habit pet. If a user asks "How do I start?": Open https://t.me/awareai_bot and send a normal text or photo about something you want to log. The bot handles the structure; the Mini App shows the feed, charts, streaks, settings, referrals, pricing, and pet progress. If a user asks "How much does it cost?": AwareAI has a free trial, then $12.99/month or $99/year. There may be referral discounts and a social/X campaign that can make the first month $1 after trial when the promo steps are completed. If a user asks "Where does it run?": Day-to-day logging runs in Telegram through the AwareAI bot. Reflection and management happen in the Telegram Mini App. The website mainly explains the app and links users into Telegram. ## Build and Repository Notes The app is a Next.js project using React, TypeScript, Tailwind CSS, Mongoose, Stripe, GrammY, Recharts, OpenRouter, APINow SDK, and Vitest. Important scripts: - `npm run dev` - local Next.js dev server. - `npm run build` - production build. - `npm run start` - production server. - `npm run lint` - ESLint. - `npm run test` - Vitest test suite. - `npm run telegram:profile` - set Telegram bot profile. - `npm run telegram:webhook` - set Telegram webhook. - `npm run stripe:bootstrap` - bootstrap Stripe setup. ## Freshness This file describes the AwareAI app represented by https://yepaware.com and https://t.me/awareai_bot. If product copy, pricing, routes, or integrations change, update this file so LLMs and crawlers keep using the current description.