https://github.com/maschlr/summaree_bot
AI assistant to transcribe, translate and summarize voice messages and audio files
https://github.com/maschlr/summaree_bot
ai ai-agents ai-assistant ai-assisted audio-processing python-telegram-bot speech-to-text speech-to-text-app telegram telegram-bot telegram-bots voice-assistant voice-chat voice-recognition
Last synced: over 1 year ago
JSON representation
AI assistant to transcribe, translate and summarize voice messages and audio files
- Host: GitHub
- URL: https://github.com/maschlr/summaree_bot
- Owner: maschlr
- License: mit
- Created: 2023-06-18T13:47:04.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2025-02-19T18:29:37.000Z (over 1 year ago)
- Last Synced: 2025-02-19T18:29:56.747Z (over 1 year ago)
- Topics: ai, ai-agents, ai-assistant, ai-assisted, audio-processing, python-telegram-bot, speech-to-text, speech-to-text-app, telegram, telegram-bot, telegram-bots, voice-assistant, voice-chat, voice-recognition
- Language: Python
- Homepage: https://summar.ee
- Size: 293 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AI Chatbot [summar.ee](https://summar.ee)
## Description
[summar.ee](https://summar.ee) is an AI chatbot for transcribing, summarizing and translating voice messages and audio files.
The bot automatically processes voice messages and audio files when it's added to a chat.
You can talk to it in a private chat or add it to a group chat.
Currently, the bot is running on [Telegram](https://telegram.org/): **[@summaree_bot](https://t.me/summaree_bot)**
### Features
- [x] User interface in four languages: 🇺🇸 English, 🇩🇪 German, 🇷🇺 Russian and 🇪🇸 Spanish
- [x] Transcribe & translate voice messages & audio files
- [x] Create & translate summary of transcripts
- [x] Add hashtags to summaries for easy search & categorization
## Development
### Create virtual environment
```bash
python3 -m venv .venv
source .venv/bin/activate
pip install -U pip
```
### Install dependencies
```bash
pip install -r requirements.txt
pip install -r requirements-dev.txt
```
### Database initialization (optional)
```bash
python -m scripts.create_database
```
## Configuration
### Environment variabels
See `summaree_bot/env.ini.example` for environment variables that need to be set.
### Database
1. Copy `alembic.ini.example`
2. Configure [postgresql database url](https://docs.sqlalchemy.org/en/20/core/engines.html#database-urls) in `alembic.ini`
## Database creation
1. `alembic revision -m "\" --autogenerate``
2. adapt migration script created in `alembic/versions/`
3. Run migration: `alembic upgrade head`
See [alembic documentation](https://alembic.sqlalchemy.org/en/latest/tutorial.html#running-our-first-migration) for more options
## Database export/import