🚀 Xioca

Xioca — современный модульный Telegram userbot-фреймворк с упором на расширяемость, UI-интерфейсы и удобство для разработчиков.

Проект ориентирован на создание и поддержку сложных пользовательских ботов с:

• гибкой системой модулей
• интерактивным inline-интерфейсом
• веб-документацией
• расширенной конфигурацией
• многоязычностью

---

✨ Ключевые особенности

• 🧩 Модульная архитектура
  Каждый модуль — это изолированный класс с lifecycle-хуками (on_load, on_unload, watchers, commands).

• 🎛 Интерактивный конфигуратор
  Настройка модулей прямо из Telegram через inline-интерфейс (кнопки, формы, пагинация, скрытые параметры).

• 🤖 Inline-бот (aiogram v3)
  Отдельный inline-бот для UI-логики, не мешающий работе userbot-клиента.

• 🌐 Web-часть
  Встроенный сайт с документацией, страницами модулей и вспомогательными API.

• 🌍 Локализация
  Поддержка нескольких языков с возможностью расширения.

• 🔐 Права и безопасность
  Owner-система, алиасы, скрытые модули, контроль доступа.

• 🔄 Updater
  Обновление проекта без ручной переустановки.

---

🧠 Архитектура

Xioca построена как самостоятельный фреймворк и состоит из нескольких ключевых подсистем:

• loader — загрузка и управление модулями
• dispatcher — обработка событий и команд
• modules — пользовательские и системные модули
• bot — inline-бот (aiogram v3)
• configurator — UI-конфигуратор модулей
• web — сайт и документация

---

📦 Установка

git clone https://github.com/yourname/xioca.git
cd xioca
pip install -r requirements.txt
python -m xioca

---

📚 Документация

👉 https://xioca.ferz.live/docs

---

🧾 Происхождение и кредиты

Xioca вдохновлён ранними Pyrogram-юзерботами и open-source экосистемой Telegram userbots, включая проект Sh1tN3t UserBot.

При этом Xioca является самостоятельным проектом с собственной архитектурой.

---

⚖️ Лицензия

AGPL-3.0