Skip to content

Vensus137/Coreness

Repository files navigation

Coreness — Мультитенантная платформа для автоматизации и AI-решений

License: MIT Python 3.11+ PostgreSQL 16+ Docker Telegram Bot API

Group Developer

🌐 Язык: Русский | English

🌐 Сайт: coreness.tech · Документация: docs.coreness.tech

Coreness — это event-driven платформа для построения автоматизированных workflow через конфигурационные файлы. Вы описываете логику в YAML, платформа управляет выполнением, хранением данных и интеграциями.

Основные сценарии использования:

  • Разработка ботов (Telegram и другие мессенджеры)
  • Автоматизация бизнес-процессов и уведомлений
  • AI-ассистенты и чат-боты с интеграцией LLM
  • Scheduled задачи и event-driven обработка

✨ Ключевые возможности

🎯 Декларативная конфигурация

Вся логика ботов описывается в YAML-файлах. Создавайте сложные сценарии, триггеры, условия и переходы без единой строки кода.

start:
  trigger:
    - event_type: "message"
      event_text: "/start"
  
  step:
    - action: "send_message"
      params:
        text: "Привет, {first_name}! 👋"
        inline:
          - [{"📋 Меню": "menu"}, {"ℹ️ Помощь": "help"}]

🏢 Мультитенантность из коробки

Один экземпляр платформы — множество независимых ботов с полной изоляцией данных:

  • Row-Level Security в PostgreSQL
  • Отдельные конфигурации, сценарии и Storage для каждого тенанта
  • GitHub-синхронизация конфигураций (Infrastructure as Code)
  • Master Bot — готовый бот для управления тенантами (аналог @BotFather)

🤖 AI и RAG

Встроенная интеграция с LLM-моделями и векторным поиском:

  • Semantic search через pgvector (PostgreSQL)
  • Поддержка OpenAI, Anthropic, Google, DeepSeek через агрегаторы (OpenRouter, Azure OpenAI)
  • RAG-контекст в сценариях — боты отвечают на основе базы знаний
  • Function calling и AI-агенты с инструментами

⏰ Scheduled сценарии

Автоматизация по расписанию через cron-выражения:

  • Ежедневные отчёты
  • Рассылки по расписанию
  • Периодические проверки и уведомления

🔧 Гибкость и расширяемость

  • Плагинная архитектура — легко добавлять новый функционал
  • Storage — гибкое key-value хранилище для настроек тенантов
  • Transitions — управление потоком выполнения сценариев
  • Placeholders — динамические данные в любых параметрах

🚀 Что внутри

🎯 Конфигурация

  • YAML-сценарии — вся логика описывается декларативно без кода
  • Триггеры — запуск по событиям, условиям или расписанию (cron)
  • 30+ Actions — отправка сообщений, AI, HTTP, валидация, оплаты и др.
  • Placeholders — динамические данные с модификаторами

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

  • Мультитенантность — изоляция данных через Row-Level Security
  • Events — событийная архитектура, низкая связность
  • Storage — key-value хранилище настроек и состояний
  • Плагины — расширяемость через утилиты и сервисы

🤖 AI и интеграции

  • AI Completion — OpenAI, Anthropic, Google, DeepSeek через агрегаторы (OpenRouter, Azure OpenAI)
  • Embeddings — генерация векторных представлений текста через AI API
  • RAG (векторный поиск) — сохранение, поиск и управление embeddings через pgvector
  • Webhooks — Telegram и GitHub синхронизация

🚀 Развертывание

  • Docker — готовые конфигурации (test + prod)
  • ...и многое другое

⭐ Дополнительные плагины и их расширения. Для получения информации свяжитесь с разработчиком


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

Онлайн: docs.coreness.tech — полная документация в браузере.

В репозитории: документация также доступна в папке docs/Навигация по документации

🚀 Быстрый старт

📋 Руководства

📚 Справочники

🔧 Расширенная документация


🏗️ Архитектура

coreness/
├── app/                 # Ядро приложения
│   ├── application.py   # Точка входа и оркестратор
│   └── di_container.py  # DI-контейнер
│
├── plugins/             # Плагинная система
│   ├── utilities/       # Утилиты
│   └── services/        # Сервисы
│
├── config/              # Конфигурации
│   ├── settings.yaml    # Глобальные настройки
│   └── tenant/          # Конфигурации тенантов
│
├── tools/               # Утилиты платформы
├── scripts/             # Скрипты
├── tests/               # Тесты
└── docker/              # Docker конфигурация

Принципы:

  • Event-Driven Architecture — низкая связность через события
  • Vertical Slice Architecture — каждый сервис самодостаточен
  • Dependency Injection — управление зависимостями через DI-контейнер
  • Multi-tenant — изоляция данных через Row-Level Security

📞 Контакты

Сайт проекта: coreness.tech
Актуальные контакты и информация

Telegram-канал проекта: t.me/coreness
Новости, обновления и обсуждения

Связь с автором: @vensus137
Вопросы, предложения, сотрудничество


📄 Лицензия

Распространяется под лицензией MIT.


Coreness — Create. Automate. Scale.