# Qubu

> Qubu — российская AI/ML платформа: модели, датасеты, ноутбуки, курсы и совместные исследования.

## Core sections

- [Models](https://qubu.ai/models): каталог ML-моделей — архитектуры, метрики, веса, инференс-опции. Поддерживает сравнение моделей и семантический поиск.
- [Datasets](https://qubu.ai/datasets): датасеты для обучения и валидации — структурированные и неструктурированные, с описаниями схем и превью.
- [Notebooks](https://qubu.ai/notebooks): интерактивные Jupyter-ноутбуки с совместным редактированием через Yjs и запуском через Gradio.
- [Learning](https://qubu.ai/learning): курсы и учебные материалы по ML/AI — видеолекции, задания, сертификаты.
- [Journal](https://qubu.ai/journal): исследовательские статьи, технические обзоры и новости платформы.
- [Forum](https://qubu.ai/forum): обсуждения, Q&A и треды по темам ML, AI и платформе Qubu.
- [Events](https://qubu.ai/events): конференции, митапы и онлайн-трансляции из мира AI/ML.
- [AI Solutions](https://qubu.ai/ai-solutions): готовые AI-решения для бизнеса — каталог с категориями и кейсами.
- [Streams](https://qubu.ai/streams): прямые трансляции и записи из области AI/ML.
- [Private Clubs](https://qubu.ai/private-clubs): закрытые сообщества для совместных исследований и проектов.

## Glossary

Model (Модель): ML-модель, опубликованная на платформе. Содержит метаданные, метрики качества, описание архитектуры и опции инференса.
Dataset (Датасет): размеченный или неразмеченный набор данных для обучения/валидации моделей. Имеет схему, ключевые слова и лицензию.
Notebook (Ноутбук): Jupyter-ноутбук с возможностью совместного редактирования и запуска в облаке.
Course (Курс): структурированная учебная программа из модулей и заданий с отслеживанием прогресса.
Journal post (Статья): исследовательская или обзорная публикация в формате Markdown с поддержкой LaTeX.
Forum thread (Тред форума): публичное обсуждение с вложенными комментариями и голосованием.
AI Solution (AI-решение): готовое бизнес-приложение на базе AI, описанное с кейсами и ценами.
Event (Событие): конференция, митап или вебинар — онлайн или офлайн.
Private Club (Приватный клуб): закрытое сообщество с контролем доступа для совместных исследований.
Embedding (Эмбеддинг): векторное представление текста или объекта для семантического поиска.
Inference (Инференс): запуск модели для получения предсказаний — через Gradio или встроенный playground.
Token (Токен): единица внутренней валюты платформы, используемая для оплаты инференса и других платных операций.

## Public API endpoints

Базовый URL: https://qubu.ai/api

GET /api/models — список моделей с фильтрацией и пагинацией
GET /api/models/{id_or_slug} — детали конкретной модели
GET /api/datasets — список датасетов
GET /api/datasets/{id_or_slug} — детали датасета
GET /api/notebooks — список ноутбуков
GET /api/notebooks/{id_or_slug} — детали ноутбука
GET /api/search/global — полнотекстовый поиск по платформе
GET /api/search/suggestions — поисковые подсказки
GET /api/journal — список статей журнала
GET /api/forum — список тредов форума
GET /api/learning — список курсов
GET /api/events — список событий
GET /api/ai-solutions — список AI-решений
GET /api/similarity — поиск похожих сущностей (семантический)
POST /api/embeddings — генерация эмбеддингов (TBD: эндпоинт в разработке, будет платным)
GET /api/health — health-check сервисов платформы

Закрытые группы (не для внешних агентов): /api/admin/*, /api/auth/*, /api/maintenance-info/*, /api/inference/*, /api/internal/*

## Content formats

Markdown — основной формат контента для статей, описаний моделей и датасетов.
:::tldr — блок краткого содержания (TBD: рендерер в разработке, Волна 2 §3.3b).
:::faq — блок часто задаваемых вопросов с поддержкой FAQPage JSON-LD (TBD: §3.3b).
LaTeX — поддержка математических формул внутри Markdown через KaTeX.
Mermaid — диаграммы внутри Markdown-контента.

## Legal

- [Terms of Service](https://qubu.ai/terms)
- Политика конфиденциальности: уточняется — страница /privacy в разработке.

## For AI agents

- [Short LLM context](https://qubu.ai/llms.txt)
- [OpenAPI 3.1 spec](https://qubu.ai/api/openapi.json)
- [Interactive API docs](https://qubu.ai/api-docs)
- [MCP server manifest](https://qubu.ai/.well-known/mcp.json)
- [Legacy ChatGPT plugin manifest](https://qubu.ai/.well-known/ai-plugin.json)
- [Sitemap](https://qubu.ai/sitemap.xml)
- [Robots](https://qubu.ai/robots.txt)