Перейти к содержанию
Новое AiManual теперь в MAX Подписаться
Публикация AiManual

Как превратить стриминг-док Ajazz AKP05E Pro в AI-ассистента: практический гайд по кастомизации

Пошаговый гайд по превращению стриминг-дока Ajazz AKP05E Pro в AI-ассистента: мониторинг CPU/GPU/RAM, отслеживание лимитов API Claude и Codex, интеграция с кале

Коротко

Что будет в материале

  1. 01

    Что вы получите после настройки: обзор возможностей

  2. 02

    Почему Ajazz AKP05E Pro: сравнение с Codex Micro и другими контроллерами

  3. 03

    Подготовка к кастомизации: что нужно установить и настроить

  4. 04

    Вывод системной информации на дисплей: CPU, GPU, RAM

Что вы получите после настройки: обзор возможностей

Стриминг-док Ajazz AKP05E Pro с 15 программируемыми клавишами, тремя поворотными ручками и дисплеем превращается в центр управления AI-задачами. После настройки вы получаете устройство, которое в реальном времени показывает загрузку CPU, GPU и RAM, отслеживает остаток токенов в API Claude и Codex, выводит ближайшие события из календаря и прогноз погоды, а крутилки управляют громкостью отдельных приложений.

Фактически это аналог Codex Micro, но с открытой архитектурой: вы не привязаны к одному вендору и можете добавлять любые функции через Python-скрипты или готовые плагины. Главный экран отображает системные метрики, по нажатию кнопки переключается на API-лимиты, ещё одно нажатие - календарь и погода. Подсветка клавиш меняет цвет при критическом остатке токенов.

Готовый профиль со всеми скриптами и конфигурациями доступен для скачивания - настройка займёт 5 минут.

Почему Ajazz AKP05E Pro: сравнение с Codex Micro и другими контроллерами

Codex Micro позиционируется как AI-девайс «из коробки», но его закрытая экосистема ограничивает кастомизацию. Ajazz AKP05E Pro стоит в 2-3 раза дешевле, имеет больше физических элементов управления и полностью открыт для программирования через HID-команды.

Характеристика Ajazz AKP05E Pro Codex Micro Stream Deck MK.2
Кнопок 15 6 15
Поворотных ручек 3 2 0
Дисплей Есть (настраиваемый) Есть (фиксированные виджеты) Нет (кнопки с экранами)
Открытое API Да (HID, Python) Нет Частично (плагины Elgato)
Цена (июль 2026) ~$60 ~$150 ~$150

Ключевое преимущество Ajazz - три поворотные ручки. В сценарии AI-ассистента они управляют громкостью микрофона, системы и браузера одновременно, что критично при созвонах с демонстрацией экрана. Stream Deck требует покупать отдельный модуль для регуляторов, Codex Micro даёт только две ручки без тонкой настройки.

Дисплей Ajazz обновляется с задержкой 200-300 мс - достаточно для мониторинга, но не для анимаций. Это аппаратное ограничение, которое есть и у Codex Micro.

Подготовка к кастомизации: что нужно установить и настроить

Для работы потребуется: драйверы Ajazz, Python 3.11+, HID-библиотеки и набор скриптов. Док подключается по USB-C, определяется системой как HID-устройство и COM-порт одновременно. На Windows 11 сборки июля 2026 года драйвер встаёт автоматически, на macOS требуется разрешить доступ к USB-устройствам в System Preferences.

Установка драйверов и утилит Ajazz

Скачайте последнюю версию Ajazz Control Center с официального сайта производителя. После установки проверьте, что док отображается в списке устройств и реагирует на нажатия. Версия прошивки должна быть не ниже 2.4.1 - старые ревизии не поддерживают отправку текста на дисплей через HID-команды.

На Windows откройте Диспетчер устройств, найдите Ajazz AKP05E Pro в разделе HID-устройств. Если устройство определяется как неизвестное, установите драйвер вручную из папки с Control Center.

Выбор среды для программирования кнопок и дисплея

Встроенное ПО Ajazz позволяет назначать клавиши на макросы и запуск программ, но не умеет выводить данные на дисплей. Для полноценной кастомизации используйте Python с библиотекой hidapi - она отправляет команды напрямую на устройство.

Новичкам подойдёт готовый пакет плагинов из репозитория проекта (ссылка в разделе «Сборка итогового профиля»). Продвинутые пользователи могут писать скрипты с нуля, используя psutil для системных метрик и requests для API-запросов.

Вывод системной информации на дисплей: CPU, GPU, RAM

Мониторинг ресурсов - базовая функция AI-ассистента. При локальном инференсе моделей загрузка GPU достигает 100%, и видеть это на отдельном экране удобнее, чем сворачивать окна для проверки в диспетчере задач.

Использование HWiNFO и плагина для Ajazz

HWiNFO экспортирует сенсоры через Shared Memory. Плагин AjazzHWiNFO читает эти данные и выводит на дисплей. Настройка: запустите HWiNFO в режиме Sensors-only, включите Shared Memory Support в настройках, установите плагин из репозитория. На дисплее появятся температура CPU, загрузка GPU и занятая RAM.

Метод не требует программирования, но ограничен фиксированным набором метрик. Частота обновления - 1 секунда, что достаточно для мониторинга.

Самописный скрипт на Python: гибкость и кастомизация

Скрипт с psutil и GPUtil даёт полный контроль над выводом. Пример кода:

import psutil
import GPUtil
import hid
import time

def get_system_info():
    cpu = psutil.cpu_percent(interval=1)
    ram = psutil.virtual_memory().percent
    gpus = GPUtil.getGPUs()
    gpu_load = gpus[0].load * 100 if gpus else 0
    gpu_temp = gpus[0].temperature if gpus else 0
    return f"CPU:{cpu:3d}% RAM:{ram:3d}%\nGPU:{gpu_load:3d}% {gpu_temp:2d}C"

# Отправка на дисплей через HID
# Код отправки зависит от прошивки, см. репозиторий

Скрипт обновляет данные каждые 2 секунды. Добавьте отображение скорости вентиляторов через psutil.sensors_fans() - полезно при длительных прогонах инференса.

Отслеживание лимитов API Claude и Codex

Исчерпание лимита токенов во время генерации кода или анализа данных ломает рабочий процесс. Док с индикацией остатка предупреждает о проблеме заранее.

Получение данных из API: ключи и лимиты

Claude API возвращает заголовки x-ratelimit-remaining-requests и x-ratelimit-remaining-tokens в каждом ответе. Codex использует аналогичные заголовки. Запросите лимиты отдельным GET-запросом к эндпоинту /v1/usage с API-ключом в заголовке Authorization: Bearer sk-ant-....

Для Claude потребуется ключ уровня Organization - личные ключи не дают доступа к статистике. В консоли Anthropic Console включите Usage API в настройках организации.

Скрипт мониторинга с выводом на док

Python-скрипт опрашивает API каждые 60 секунд и обновляет дисплей. Цветовая схема: зелёная подсветка клавиш при остатке выше 50%, жёлтая - ниже 20%, красное мигание - ниже 5%.

import requests
import time

API_KEY = "sk-ant-your-key"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

def check_limits():
    resp = requests.get("https://api.anthropic.com/v1/usage", headers=HEADERS)
    data = resp.json()
    remaining = data.get("remaining_tokens", 0)
    limit = data.get("limit_tokens", 1)
    pct = (remaining / limit) * 100
    return pct, remaining

# Отправка на дисплей и управление подсветкой
# Полный код в репозитории

При падении остатка ниже 5% скрипт отправляет HID-команду на мигание всех клавиш - пропустить такое предупреждение сложно.

Интеграция с календарем и погодными сервисами

Быстрый взгляд на док заменяет проверку смартфона. Ближайшая встреча и прогноз на день выводятся на отдельный экран, переключение - одна кнопка.

Настройка Google Calendar API

Создайте проект в Google Cloud Console, включите Calendar API, получите OAuth 2.0 credentials. Установите библиотеку google-api-python-client. Скрипт запрашивает события на текущий день и выводит первые три с временем начала:

from googleapiclient.discovery import build
from datetime import datetime

def get_events():
    service = build('calendar', 'v3', credentials=creds)
    now = datetime.utcnow().isoformat() + 'Z'
    events_result = service.events().list(
        calendarId='primary', timeMin=now,
        maxResults=3, singleEvents=True,
        orderBy='startTime'
    ).execute()
    return events_result.get('items', [])

Отображение погоды через OpenWeatherMap

Зарегистрируйтесь на OpenWeatherMap, получите бесплатный API-ключ (1000 запросов в день). Скрипт запрашивает текущую погоду по городу и выводит температуру, влажность и описание одной строкой:

import requests

def get_weather(city="Moscow"):
    url = f"http://api.openweathermap.org/data/2.5/weather?q={city}&appid={API_KEY}&units=metric"
    data = requests.get(url).json()
    temp = data['main']['temp']
    desc = data['weather'][0]['description']
    return f"{temp:.0f}C {desc}"

Оба скрипта объединяются в один поток, который обновляет данные раз в 10 минут - API-лимиты бесплатных тарифов соблюдаются.

Настройка крутилок для микширования звука

Три поворотные ручки - это физический микшер для Windows. При работе с голосовыми AI-агентами, как в связке LangSmith с Pipecat и LiveKit, раздельное управление громкостью микрофона, системы и браузера экономит время на переключении между окнами.

Управление громкостью приложений через pycaw

Библиотека pycaw даёт доступ к Windows Audio Session API. Каждая крутилка привязывается к конкретному процессу:

from pycaw.pycaw import AudioUtilities, ISimpleAudioVolume

def set_app_volume(process_name, volume_level):
    sessions = AudioUtilities.GetAllSessions()
    for session in sessions:
        if session.Process and session.Process.name() == process_name:
            volume = session._ctl.QueryInterface(ISimpleAudioVolume)
            volume.SetMasterVolume(volume_level, None)

# Привязка крутилки к Discord
# volume_level от 0.0 до 1.0

Настройте три крутилки: левая - системные звуки, средняя - Discord или Zoom, правая - браузер. При повороте ручки скрипт считывает HID-событие и вызывает set_app_volume с новым значением.

Готовые решения: Voicemeeter и макросы

Voicemeeter Banana создаёт виртуальные аудиоканалы, а Control Center Ajazz назначает крутилки на эмуляцию нажатий клавиш. Метод проще в настройке, но добавляет задержку 50-100 мс и занимает виртуальные входы. Подходит, если вы не хотите писать код.

Сборка итогового профиля: объединяем все функции

Все скрипты работают в фоновом режиме как Python-процессы. Главный скрипт-диспетчер слушает нажатия кнопок и переключает экраны: кнопка 1 - системные метрики, кнопка 2 - API-лимиты, кнопка 3 - календарь и погода. Крутилки активны всегда, независимо от выбранного экрана.

Готовые плагины и конфигурации для быстрого старта

В репозитории проекта выложен пакет со всеми скриптами, файлом конфигурации config.yaml и инструкцией по запуску. После клонирования репозитория и установки зависимостей (pip install -r requirements.txt) достаточно запустить python main.py и указать свои API-ключи в конфиге.

«Из коробки» работают: мониторинг CPU/GPU/RAM через psutil, отслеживание лимитов Claude с цветовой индикацией, календарь Google и погода OpenWeatherMap, управление громкостью через pycaw. Переключение экранов назначено на кнопки 13-15.

Если вы проектируете AI-агентов с нуля, обратите внимание на нашу статью об архитектуре самописных AI-агентов - там разобраны оркестрация LLM, память и обработка ошибок с цифрами по latency и cost. Для тех, кто работает с десктопными AI-инструментами, будет полезен обзор Koda Desktop - универсального AI-агента для тестировщиков и аналитиков. А если вы задумываетесь о более глубокой интеграции AI в рабочие процессы, почитайте наш разбор личных ИИ-агентов, которые живут в мессенджере и управляют проектами 24/7.

Ограничения и подводные камни

Дисплей обновляется с задержкой 200-300 мс - анимации и плавные переходы невозможны. Это ограничение прошивки, не снимается никакими скриптами.

HID-команды на отправку текста различаются между ревизиями дока. Если после обновления прошивки дисплей перестал принимать данные, проверьте версию в Control Center и сверитесь с документацией к репозиторию.

Google Calendar API требует OAuth-токен, который истекает через 7 дней в тестовом режиме. Для постоянной работы переведите проект в production или добавьте автоматическое обновление токена через refresh_token.

pycaw работает только на Windows. На macOS используйте библиотеку osascript для управления громкостью - примеры есть в репозитории.

При одновременной работе HWiNFO и самописного скрипта возможны конфликты доступа к сенсорам. Выберите один метод мониторинга.

Заключение: ваш персональный AI-ассистент готов

Ajazz AKP05E Pro с набором скриптов закрывает три ключевые потребности: мониторинг ресурсов при инференсе, контроль API-лимитов и быстрое переключение между задачами через физические элементы управления. Цена решения - $60 за док и час на настройку.

Дальнейшие направления кастомизации: интеграция с Ollama для отображения статуса локальных LLM, управление умным домом через Home Assistant API, вывод уведомлений из CI/CD пайплайнов. Код открыт, pull requests приветствуются.

Подписаться на канал