Create Tammy, the Achievement Tracking AI Bot
Create an AI agent that checks in daily, celebrates wins, and helps users maintain a record of their accomplishments
Project Overview
Video Intro
Get a quick overview over what you'll build
Quick Access Resources
Essential links and downloads to help you get started quickly
A1 Framework Template
Start with the official A1Base NextJS template - the foundation for this tutorial and all A1Base projects.
Source code of completed project
Get the complete source code to build your own achievement tracking bot.
Live Demo
Experience the achievement bot in action before building your own version.
Project Files
Download all necessary files including templates and configuration.
Project Setup
Initial configuration and requirements to begin development
Prerequisites
- Node.js 18+ installed
- An A1Base account with API access
- Basic knowledge of React and TypeScript
- Git installed on your system
Clone the A1Framework repository:
git clone https://github.com/a1baseai/a1framework.git achievement-tracker
Navigate to the project directory:
cd achievement-tracker
Install dependencies:
npm install
Note: A1Framework is a heavily modified NextJS template custom built for a singular AI conversational item. It provides all the necessary components and utilities to build conversational AI agents quickly.
For more detailed information on setting up your development environment, please refer to our NPM Setup Guide.
Implementation Guide
Step-by-step instructions for building your achievement tracking system
1. Setting Up the AI Agent Personality
We'll start by configuring the AI agent with the right personality and response patterns.
Open the src/lib/agent-profile-settings.ts file in your A1Framework project and customize the agent's personality, name, and description to match Tammy's supportive and encouraging nature.
Pro Tip: Focus on making Tammy's personality enthusiastic and supportive. Use positive language that celebrates achievements of all sizes and provides encouragement.
2. Implementing Daily Check-ins with Cron Jobs
Next, we'll set up the scheduling system for daily achievement check-ins using A1Base's Cron Jobs feature.
- Navigate to A1Base Cron Jobs Dashboard
- Click "Create New Cron Job" and configure the following settings:
- Endpoint URL: Your achievement bot's check-in endpoint
- Frequency: Daily
- Time: Choose when you want check-ins to occur (e.g., 9:00 AM)
- HTTP Method: POST
- Add appropriate headers and request body for authentication
Note: Create an API endpoint in your A1Framework project at src/pages/api/daily-checkin.ts to handle the incoming cron job requests and trigger your achievement check-in flow.
3. Building the Achievement Database
Learn how to store and track achievements over time with a structured database approach.
The A1Framework includes a built-in database connector. Configure your achievement schema in src/models/achievement.ts with the following structure:
interface Achievement {
id: string;
userId: string;
date: Date;
content: string;
category?: string;
sentiment?: number; // 1-5 rating of positivity
createdAt: Date;
}Implement the necessary CRUD operations in src/services/achievement-service.ts to store and retrieve user achievements efficiently.
4. Connecting to A1Base API
Set up the connection to the A1Base API for enhanced AI capabilities and natural conversations.
In your .env.local file, add your A1Base API key:
A1BASE_API_KEY=your_api_key_here A1BASE_AGENT_ID=your_agent_id
Configure the connection in src/services/a1base.ts to enable the advanced conversational capabilities needed for Tammy to provide personalized responses and track achievements effectively.
5. Testing Your Achievement Bot
Before deploying, thoroughly test your achievement tracking bot to ensure it works as expected.
Manual Testing
- Test conversation flows
- Verify achievement storage
- Check personality consistency
Cron Job Testing
- Test endpoint manually
- Verify scheduled triggers
- Check notification delivery
Customization Ideas
Ways to extend and personalize your achievement tracking bot
- • Customize achievement categories and tracking metrics
- • Add weekly/monthly achievement summaries
- • Integrate with task management tools
- • Implement team achievement tracking
- • Add motivational quotes or resources
Share what you've built
Showcase your work and inspire others in the community
Proud of what you built? Share it with the community and inspire others!
Try Tammy Now
Try this A1Base Conversational AI Agent
Tammy - Achievement Tracker
Your personal achievement tracking assistant that helps you celebrate wins and stay motivated.
Bot Capabilities:
- • Daily achievement check-ins
- • Progress tracking over time
- • Personalized encouragement
- • Weekly achievement summaries
- • Goal setting assistance
Personality:
Tammy is supportive, enthusiastic, and focused on celebrating even small wins. She's your personal cheerleader who helps you recognize your progress.