Personal Development Coach Telegram Bot

Introduction

The Personal Development Coach Telegram Bot is an intelligent assistant designed to help users manage their personal development goals seamlessly through Telegram. Integrated with Todoist, it allows users to track tasks and receive personalized coaching advice powered by advanced AI models.

Features

• Task Management: Sync and manage Todoist tasks directly within Telegram.
• Personalized Coaching: Receive tailored advice on goal setting, motivation, and personal growth.
• Natural Language Processing: Advanced AI understands and responds to user queries effectively.
• Real-time Updates: Get instant feedback and task updates through the Todoist API.
• User-Friendly Interface: Simple commands and interactions designed for ease of use.

Architecture

The bot uses a modular architecture with clear separation of concerns:

• Core Components:

  • agent.py: Orchestrates the LangGraph workflow and state management
  • state.py: Defines the state management types and merge functions
  • models.py: Pydantic models for data validation and type safety

• Nodes:

  • nodes/chat.py: Handles AI conversation using LangChain and GPT models
  • nodes/get_tasks.py: Manages Todoist task synchronization

• Utils:

  • utils/todoist.py: Todoist API client implementation
  • utils/telegram.py: Telegram bot setup and message handling
  • utils/agent_handler.py: Agent interaction management
  • utils/prompts.py: System prompts and message templates

Technology Stack

• Programming Language: Python 3.8+

• Core Frameworks:

  • Aiogram: Telegram bot framework
  • LangGraph: Workflow orchestration
  • LangChain: LLM integration
  • OpenAI GPT: Language model
  • Todoist API: Task management

• Supporting Libraries:

  • Pydantic: Data validation
  • HTTPX: Async HTTP client
  • python-dotenv: Environment management

Installation

Prerequisites

• Python 3.8 or higher
• Git
• Todoist Account
• Telegram Account

Steps

1. Clone the Repository

   git clone https://github.com/saminkhan1/focuscoach.git
   cd personal-dev-coach-bot   ```
   

2. Create a Virtual Environment

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate   ```
   

3. Install Dependencies

   pip install -r requirements.txt   ```
   

Configuration

1. Environment Variables

   Create a .env file in the root directory and add the following variables:

   TELEGRAM_BOT_TOKEN=your_telegram_bot_token
   TODOIST_API_TOKEN=your_todoist_api_token   ```
   
   - **TELEGRAM_BOT_TOKEN:** Obtain from [BotFather](https://telegram.me/BotFather) on Telegram.
   - **TODOIST_API_TOKEN:** Get from [Todoist Integration Settings](https://todoist.com/prefs/integrations).
   

2. Additional Configuration

   You can customize other settings such as logging levels or API endpoints by modifying the respective configuration files or environment variables as needed.

Usage

1. Start the Bot

   python telegram_bot.py   ```
   
   The bot will start polling for messages. Ensure that your environment variables are correctly set.
   

2. Interact with the Bot

   • /start: Initialize your session and receive a welcome message.
   • General Messages: Ask questions or seek advice on personal development topics.

3. Task Management Commands

   • Add Task: You can add tasks to your Todoist directly through the bot.
   • Close Task: Mark tasks as completed via bot commands.
   • View Tasks: Retrieve and view your current tasks.

Contributing

Contributions are welcome! Please follow these steps to contribute:

1. Fork the Repository

2. Create a Feature Branch

   git checkout -b feature/YourFeature   ```
   

3. Commit Your Changes

   git commit -m "Add some feature"   ```
   

4. Push to the Branch

   git push origin feature/YourFeature   ```
   

5. Open a Pull Request

   Submit a pull request detailing your changes for review.

Project Structure

my_coach/
├── my_coach/
│ ├── init.py
│ ├── agent.py # LangGraph workflow definition
│ ├── models.py # Pydantic data models
│ ├── state.py # State management
│ ├── nodes/
│ │ ├── init.py
│ │ ├── chat.py # Chat processing node
│ │ └── get_tasks.py # Task synchronization node
│ └── utils/
│ ├── init.py
│ ├── agent_handler.py # Agent interaction logic
│ ├── prompts.py # System prompts
│ ├── telegram.py # Telegram bot setup
│ └── todoist.py # Todoist API client