An open API service indexing awesome lists of open source software.

https://github.com/noras2001/aiogram_personal_financial_assistant

a personal financial assistant chatbot
https://github.com/noras2001/aiogram_personal_financial_assistant

aiogram chatbot financial-assitance-answers python telegram-bot

Last synced: 21 days ago
JSON representation

a personal financial assistant chatbot

Awesome Lists containing this project

README

          

# Личный финансовый помощник на базе Aiogram

Этот репозиторий содержит код для чат-бота, который помогает пользователям вести учет своих финансов, предоставляет информацию о курсах валют и дает советы по экономии.

## Описание

Бот предоставляет несколько опций:
1. **Регистрация**: Пользователь может зарегистрироваться в системе, и его данные сохраняются в базе данных SQLite.
2. **Курс валют**: Пользователь может получить текущие курсы валют (USD и EUR к RUB).
3. **Советы по экономии**: Бот предоставляет случайные советы по экономии.
4. **Личные финансы**: Бот помогает пользователю вести учет своих расходов, разделяя их на три категории.

### Основные функции

- **Регистрация**: Пользователь вводит команду `/start` и может зарегистрироваться в боте. Если пользователь уже зарегистрирован, он получит соответствующее сообщение.
- **Курс валют**: Бот получает актуальные данные о курсе валют с API и отображает их.
- **Советы по экономии**: Бот выдает случайные советы по экономии из заранее заданного списка.
- **Личные финансы**: Пользователь вводит категории расходов и суммы для каждой категории. Все данные сохраняются в базе данных SQLite.

## Как запустить

1. Установите все необходимые зависимости:
```bash
pip install aiogram sqlite3 requests
```

2. Создайте файл `config.py` с вашим токеном:
```python
TOKEN = "your-bot-token-here"
```

3. Запустите бота:
```bash
python bot.py
```

4. Бот начнет работать, и вы сможете взаимодействовать с ним в Telegram.

## Структура проекта

- **bot.py**: Основной файл, содержащий логику бота.
- **config.py**: Файл с конфигурацией (токен бота).
- **user.db**: База данных SQLite для хранения данных пользователей (категории расходов, суммы).

## Пример взаимодействия с ботом

1. Пользователь отправляет команду `/start`.
2. Бот предлагает меню с опциями, например:
- Регистрация в боте
- Курс валют
- Советы по экономии
- Личные финансы
3. Если пользователь выбирает "Курс валют", бот отвечает актуальными курсами:
```
1 USD - 75.00 RUB
1 EUR - 88.00 RUB
```
4. Если пользователь выбирает "Личные финансы", бот попросит ввести категории расходов и суммы для каждой из них.

## Лицензия

Этот проект лицензируется на условиях MIT.