ekogram 2.4

Lightweight library for working with Telegram Bot Api + Generate Images, Audio and Text

Ekogram

Ekogram — лёгкий Python-модуль для Telegram Bot API и работы с нейросетями.
Он объединяет простую работу с Telegram и мощные функции: генерация текста и изображений, перевод и озвучка.

Установка

pip install ekogram

или для macOS:

pip3 install ekogram

Возможности

• Telegram Bot API: отправка сообщений, медиа, inline, reply клавиатуры и т.п.
• Мощные AI-инструменты: ИИ, генерация картинок, перевод, озвучка.
• Поддержка классов Telegram: Message, User, Chat, Audio, Photo, Voice и т.д.
• Работа с callback_query, inline_query, handlers

---

🤖 Быстрый старт бота

from ekogram import Bot

bot = Bot("ВАШ_ТОКЕН")

@bot.message_handler(commands=["start"])
def start_handler(message):
    bot.reply_message(chat_id=message.chat.id, text="Привет! Я бот Ekogram!")

bot.polling()

---

🧠 Использование AI

OnlySQ — бесплатный набор ии; Deef - дополнительные функции

from ekogram import OnlySQ, Deef

gpt = OnlySQ()
gpt2 = Deef()

messages = [
    {"role": "system", "content": "Отвечай кратко и по делу"},
    {"role": "user", "content": "Расскажи, кто такой Эйнштейн?"}
]

print(gpt.generate_answer("gemini-2.5-flash", messages))
print("\n\n"+gpt2.toolchat("hi"))

OnlySQ — генерация картинок

from ekogram import OnlySQ

img = OnlySQ()
print(img.generate_image(prompt="cyberpunk robot with fire"))

Deef — перевод текста

from ekogram import Deef

tr = Deef()
print(tr.translate("Hello, how are you?", target="ru"))

ChatGPT — сессия с GPT

from ekogram import ChatGPT

chat = ChatGPT(url='https://chatgpt.com', headers={})
print(chat.generate_chat_completion(model="gpt-4o-mini", messages=[{"role": 'user', "content": "Hi"}]))

---

🎤 Озвучка текста

from ekogram import Deef

gpt = Deef()
gpt.speech(text="Привет, как дела?", filename="voice", voice="nova")    #filename -> voice.mp3

---

📎 Пример кнопок

from ekogram import Bot, Markup

bot = Bot("TOKEN")

@bot.message_handler(commands=["menu"])
def menu(message):
    buttons = [{"text": "Кнопка 1"}, {"text": "Кнопка 2"}]
    markup = Markup.create_reply_keyboard(buttons)
    bot.reply_message(chat_id=message.chat.id, text="Выберите вариант:", reply_markup=markup)

---

📌 Поддерживаемые классы

• Telegram: User, Chat, Message, File, Photo, Voice, Video, Sticker, Document, Location, Dice и др.
• InputMedia: InputMediaPhoto, InputMediaVideo, InputMediaAudio, InputMediaDocument, InputMediaAnimation
• Inline: InlineQuery, InlineQueryResultArticle, InlineQueryResultPhoto, InlineQueryResultVideo
• Markup: Markup.create_inline_keyboard(), Markup.create_reply_keyboard(), Markup.remove_reply_keyboard()
• AI: OnlySQ, Deef, ChatGPT

---

🔒 Лицензия

MIT License

📫 Обратная связь

Email: [e-mail]

Если возникнут идеи, баги, предложения — пишите 🙌