✦ NEXT-GEN OPEN ECOSYSTEM ✦

superLuna

Современная экосистема открытых инструментов, текстовых студий и интеллектуальных голосовых мостов нового поколения.

// ECOSYSTEM WORKSPACE

Ключевые проекты

Свободные инструменты для работы с текстом, голосовым ИИ и автоматизацией.

HOT PROJECT Voice AI Webhook Vercel Serverless

GenStation v1.0 (main)

Умный серверлесс-мост между голосовым помощником Яндекс Алиса, мощной нейросетью Google Gemini и поиском реального времени Serper. Нулевая стоимость поддержки и запуск в 2 клика.

✓ 3900 мс лимит таймаута

✓ Чистый синтез речи (TTS)

✓ Защита safeHistory

GitHub tree/main

OpenText webStudio

Облачный редактор документов

Web App

Молниеносная веб-студия для форматирования и структурирования текстового контента. Без сложной регистрации, моментальный старт прямо из браузера.

// Основной хост:

https://opentext.luna-app.space

Перейти в webStudio GitHub

OpenText Studio

Desktop Edition

Native

Локальное десктопное приложение для работы с документами и текстами высокой сложности без постоянного подключения к сети.

Offline-first Fast Markdown

Репозиторий OpenText Studio

Telegram Канал superLuna

Прямой канал с релизами, обновлениями GenStation и новостями сообщества: t.me/app_luna

Перейти в канал

/ GenStation

github.com/magic4n/GenStation

GenStation

Умный мост между голосовым помощником Яндекс Алиса, нейросетью Google Gemini и поиском Serper.

Platform: Vercel Serverless Model: Google Gemini Voice: Yandex Alice License: MIT

GitHub (tree/main) Развернуть на Vercel (1 клик)

// HIGH LEVEL DATA FLOW

Архитектура взаимодействия

01 / USER

Пользователь

Произносит голосовой вопрос Яндекс Станции или приложению Алиса.

Голос / Текст

02 / DIALOGS

Яндекс Диалоги

Преобразует речь в текст и отправляет вебхук POST /api на ваш сервер.

HTTPS Webhook

03 / CORE

GenStation Core

Бессерверный обработчик на Vercel. Проверяет намерения, историю и запускает ИИ.

Бюджет: 3900 мс

04 / AI & SEARCH

Gemini + Serper

Генерирует лаконичный ответ без Markdown для живой озвучки Алисой.

Google Gemini API

// CORE FEATURES

Почему именно GenStation?

⚡

Молниеносный тайминг

Яндекс Диалоги требуют ответ не позже 4.5 секунд. В GenStation встроен строгий лимит TOTAL_RESPONSE_BUDGET_MS = 3900 мс, гарантирующий отсутствие разрывов связи.

🗣️

Чистый синтез TTS

Автоматическое вырезание Markdown-разметки (звездочек, решёток, ссылок) и умная расстановка естественных пауз, чтобы колонка не читала символы вслух.

🌐

Поиск в реальном времени

Интеграция с Serper API позволяет Алисе отвечать на вопросы о свежем курсе валют, сегодняшней погоде и событиях текущего дня.

🧠

Защита safeHistory

Gemini требует строгого чередования ролей (user ↔ model). GenStation предотвращает ошибку 400 и мягко склеивает повторные реплики.

🔘

Кнопки-саджесты

Поддержка интерактивных подсказок и кнопок на экранах Яндекс Станции Дуо Макс, планшетах и мобильных телефонах.

💸

0₽ расходов

Полностью работает на бесплатных тарифах Vercel Serverless Functions, Google AI Studio и Serper без необходимости аренды VPS.

// STEP-BY-STEP SETUP

Руководство по установке

Полный процесс развертывания навыка от получения ключей до голосового теста.

ШАГ 1 API Токены

Получение API-ключей

Вам понадобятся ключи от Google AI Studio (обязательно) и Serper (рекомендуется для веб-поиска):

1. Google AI Studio → Нажмите Get API key → Создайте и скопируйте ключ.
2. serper.dev → Зарегистрируйтесь (2500 бесплатных запросов) и скопируйте токен.

ШАГ 2 Vercel Deploy

Импорт репозитория в Vercel

Вам не нужно форкать проект или скачивать файлы. Достаточно указать ссылку на GitHub:

https://github.com/magic4n/GenStation

В панели Vercel Dashboard нажмите Add New… → Project, вставьте URL и нажмите Deploy.

ШАГ 3 Environment Variables

Переменные окружения Vercel

Перейдите в проект Vercel: Settings → Environment Variables и укажите:

Переменная	Обязательно	Описание
GEMINI_API_KEY	Да	Ключ Google Gemini API
SERPER_API_KEY	Нет	Ключ поиска актуальных данных
GEMINI_MODEL	Нет	Модель (по умолчанию: gemini-2.5-flash)

⚠️ Важно: после добавления переменных выполните Redeploy в Deployments!

ШАГ 4 КРИТИЧЕСКИ ВАЖНО

Настройка в Яндекс Диалогах

В кабинете Яндекс Диалогов укажите адрес: https://ваш-проект.vercel.app/api

Внимание! Обязательно снимите галочку с пункта «Хранить хранилище данных в навыке» (или «Использовать хранилище данных пользователя»). Включение этой галочки вызывает фатальную ошибку Empty Response. Вся история в GenStation надежно передается через session state!

ШАГ 5 Голосовой тест

Запуск и тестирование

Произнесите в любую колонку Яндекс Станция или приложение Яндекс:

«Алиса, запусти навык [ваше имя навыка]» Голос

// TROUBLESHOOTING

FAQ и решение ошибок

                🔴 Ошибка «Empty Response» (Навык вернул пустой ответ)
                +
              
                Причина — активный чекбокс долгосрочного хранилища данных пользователя. Зайдите в Настройки диалога и снимите галочку с «Хранить хранилище данных в навыке». История диалога поддерживается автоматически через сессию.

                ⏱️ Алиса говорит: «Навык не отвечает» (Тайм-аут 4.5 секунды)
                +
              
                Используйте быструю модель (например, gemini-2.5-flash). Тяжелые модели Pro не укладываются в голосовые лимиты. Также первый «холодный старт» Vercel может занимать чуть больше времени, следующие запросы идут мгновенно.

                🔑 Код 401/403: GEMINI_KEY_REJECTED или User location not supported
                +
              
                Проверьте точность значения GEMINI_API_KEY в настройках Vercel и обязательно нажмите Deployments → Redeploy. Функции Vercel по умолчанию работают в дата-центрах США и Европы, где Gemini API разрешён.

                📢 Алиса произносит «звёздочка, решётка, скобка»
                +
              
                В GenStation встроена функция cleanMarkdown() и строгие системные инструкции, очищающие форматирование перед передачей в TTS Алисы.

// ВСТРОЕННЫЕ ГОЛОСОВЫЕ КОМАНДЫ

«Сброс» / «Забудь»

Очищает историю памяти текущей беседы

«Помощь»

Выводит подсказки и возможные темы

«Стоп» / «Выход»

Завершает сеанс навыка Алисы