Cultural Coder uses AI to power its tutor, code helper, and recommendation engine. To keep the platform sustainable and fair for everyone, we use a credit system that limits how many AI interactions each user can have per day. Here is everything you need to know about AI credits.

What Are AI Credits?

An AI credit is one interaction with our AI tutor, code helper, or recommendation engine. When you ask Tafadzwa to explain a concept, get help with your code, or receive a personalized next-step recommendation, that counts as one AI credit.

The credit system exists because AI processing costs real money. Each interaction sends your question to Google's Gemini AI model, which generates a personalized response based on your learning style, totem, and progress. By limiting daily usage, we keep the platform free for everyone while ensuring quality responses.

Free Tier Limits

Every registered user gets 20 AI credits per day on the free tier. This resets at midnight (Harare time) every day. Your credits are tracked both on the server (for accurate counting) and on your device (for fast display).

With 20 credits per day, you can:

Ask the AI tutor to explain 5-10 concepts in depth
Get help with 3-5 code debugging sessions
Receive 2-3 personalized recommendations
Complete 2-3 placement or practice quizzes

For most learners, 20 credits per day is more than enough to make consistent progress.

Premium Tier: 200 Credits Per Day

Premium subscribers get 200 AI credits per day — ten times the free tier. This is ideal for:

Learners who want unlimited AI tutoring sessions
Instructors who use the platform for classroom teaching
Power users who frequently use the code playground and AI explainer

Premium costs $5 USD per month, $12 USD per quarter, or $40 USD per year. You can pay via EcoCash, Paynow, or ZiG (Zimbabwe Gold).

Tips to Maximize Your Free Credits

Cache works in your favor: If you ask the same question twice, the AI uses a cached response — this does not count against your credits.
Use the code playground freely: Running code in the playground is completely free. Only AI-assisted features use credits.
Read lessons first: The text content of every lesson is always free. Only the AI tutor explanations use credits.
Batch your questions: Instead of asking one question at a time, think about what you want to learn and ask comprehensive questions.
Check your dashboard: Your dashboard shows exactly how many credits you have remaining today. The progress bar turns red when you are running low.
Use the placement quiz wisely: The placement quiz uses one credit per session. Take it once to get your starting point, then focus on lessons.

How Credits Are Tracked

Credits are tracked at two levels:

Server-side: The authoritative count, stored in your Firestore user document. This is checked by every AI action before processing.
Client-side: A fast display count stored in your browser's localStorage. This updates instantly for the UI but resets if you clear your browser data.

The server-side count always takes precedence. If there is a discrepancy, the server wins.

What Happens When You Run Out

When you reach your daily limit, the AI tutor and code helper will display a message saying your limit has been reached. You can still:

Read all lesson content
Run code in the playground
Track your progress
View your dashboard

Your credits reset automatically at midnight Harare time. You do not need to do anything.

Upgrading to Premium

If you find yourself running out of credits regularly, upgrading to premium is the best option. Premium also includes:

Faster AI model responses
Priority support
Ad-free experience
Downloadable certificates
Early access to new features

Visit the Premium page to see current pricing and payment options. You can pay with EcoCash, Paynow, or ZiG.

Related Resources

Premium Plans — Upgrade for unlimited AI access
AI Tutor — Try Tafadzwa with your free credits
Python for Beginners — Start coding today
Coding Glossary — 58 terms in English, Shona, and Ndebele
Dashboard — Track your AI usage and progress