Skip to content

lintware/telegramcaller

Repository files navigation

telegramcaller - AI receptionist for your Telegram number

Python 3.12+ Telegram MTProto gpt-realtime-2 Codex Claude Code License: MIT

telegramcaller

Turn your personal Telegram account into a realtime voice agent.

telegramcaller skill lets a coding agent turn your Telegram account into a live voice agent using the voice product you choose. Ship with gpt-realtime-2 by default, or tell your agent which provider you want and let it wire up the rest.

Installation

npx skills add lintware/telegramcaller

If a required system dependency is missing, ask your coding agent to install it.

How to use

Text your coding agent:

Use the telegramcaller skill to make my Telegram account a voice agent

What It Will Ask You

Prompt What to provide
Telegram API ID From https://my.telegram.org
Telegram API hash From https://my.telegram.org
Telegram phone number Include country code
Voice model default gpt-realtime-2
Provider API key For example, OPENAI_API_KEY
Telegram login code Sent by Telegram during setup
Telegram 2FA password Only if 2FA is enabled

By default, the voice model is gpt-realtime-2 with the alloy voice.

Call recordings are saved in recordings/ as mixed WAV files.

License

MIT - use at your own risk. Be courteous: tell callers when they are talking to an AI.

See CONTRIBUTING.md for development and PR guidelines.

About

Turn your personal Telegram account into a realtime voice agent that answers private calls and connects to your V2V provider

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages