Автоматизация деплоя Smolagents с Hugging Face на VPS: cron + PostgreSQL

kirilljsx

Smolagents от Hugging Face - это свежий фреймворк для AI-агентов, где всё запускается парой строк кода. Хочешь задеплоить такого зверя на свой VPS, чтобы он работал автономно, логировал в PostgreSQL и обновлялся по крону? Этот гайд разберёт процесс шаг за шагом - от скачивания до полной автоматизации.

Зачем это нужно? Ручной деплой надоедает быстро, особенно если агенты мониторят Reddit или парсят новости. С cron и базой ты получишь стабильную систему: обновления на автопилоте, логи в PostgreSQL для анализа, минимум даунтайма. Подходит для пет-проектов или бизнеса, где AI должен пахать 24/7 без твоего участия.

Готовим VPS и окружение

Smolagents - легкий фреймворк, но на VPS нужно настроить Python, зависимости и безопасность. Представь: сервак на Ubuntu, свежий Python 3.12, виртуальное окружение. Устанавливаем pip, git, PostgreSQL - и уже можно клонировать репозиторий с Hugging Face. Главное - изолировать агента, чтобы его код не навредил системе.

Безопасность здесь критична: CodeAgent генерит Python-код на лету, так что используем sandbox вроде E2B или енный интерпретатор. На VPS это спасёт от фризов или worse. Пример: агенты с DuckDuckGo для поиска - они жрут мало ресурсов, но без логов не поймёшь, что пошло не так. Переходим к PostgreSQL для хранения состояний и метрик.

Установи зависимости: sudo apt update && sudo apt install python3-pip python3-venv postgresql git
Создай venv: python3 -m venv smolenv && source smolenv/bin/activate
Подключи PostgreSQL: создай базу smolagents_db, юзера с паролем, настрой psycopg2 для Python
Клонируй шаблон: git clone https://huggingface.co/spaces/agents-course/First_agent_template

Команда	Описание	Почему важно
apt install postgresql	База для логов агентов	Без неё мониторинг - лотерея
pip install smolagents	Основной фреймворк	Поддержка CodeAgent и ToolCallingAgent
pip install psycopg2-binary	Драйвер для PG	Храни промпты, ответы, ошибки

Пишем скрипт агента с PostgreSQL

Теперь сердце - сам агент. Берем CodeAgent: он думает, пишет код, действует. Добавляем кастомные инструменты: логи в PG, веб-поиск через DuckDuckGo. Пример: агент парсит Reddit на свежие ИИ-релизы и сохраняет в базу. Всё в app.py - импорты, модель через InferenceClientModel, инструменты с @tool.

Промпт для агента простой: “Мониторь subreddit r/MachineLearning, извлекай топ-посты, сохраняй в PG с тегами”. Модель берём с HF Hub - qwen2 или phi-3, они лёгкие для VPS. Логируем каждый шаг: запрос, ответ, токены. Если ошибка - rollback в транзакции PG. Это решает проблему: агенты не теряют состояние между запусками.

Импорт: from smolagents import CodeAgent, DuckDuckGoSearchTool; import psycopg2; from tools.final_answer import FinalAnswerTool
Ключевой инструмент для PG:

def log_to_pg(data: str, agent_id: str) -> str:
    """Логирует данные агента в PostgreSQL. Args: data - JSON строка, agent_id - уникальный ID."""
    conn = psycopg2.connect(...)
    cur = conn.cursor()
    cur.execute("INSERT INTO agent_logs (agent_id, data) VALUES (%s, %s)", (agent_id, data))
    conn.commit()
    return "Logged successfully"

Запуск: agent = CodeAgent(tools=[DuckDuckGoSearchTool(), log_to_pg], model=InferenceClientModel(...))
Нюанс: Укажи в промпте типы аргументов - smolagents парсит докстринги автоматически.

Настраиваем cron для автодеплоя

Автоматизация - это когда скрипт сам обновляется с HF Hub и перезапускается. Crontab на VPS: еженедельный git pull, pip install -r requirements.txt, тест агента, рестарт сервиса. Используем systemd для daemon’а - agent.service с ExecStart на app.py.

Представь: @weekly cd /path/to/smolagents && git pull origin main && pip install -U smolagents && systemctl restart smolagent. Добавь healthcheck: скрипт пингует PG, проверяет модель. Если VPS слабый - Ollama для локальных моделей, без HF API. Это экономит бабки и ускоряет.

Crontab команды:
1. crontab -e
2. Добавь: 0 2 * * 0 /usr/bin/bash /path/update_smol.sh - обновление по воскресеньям
3. Скрипт update_smol.sh: git pull, pip freeze > requirements.txt, restart

Systemd юнит:

[Unit]
Description=Smolagents AI
[Service]
ExecStart=/path/smolenv/bin/python app.py
Restart=always
[Install]
WantedBy=multi-user.target

Мониторинг: systemctl status smolagent + алерты в PG на ошибки

Проблема	Решение в cron	Эффект
Устаревшие deps	pip install -U	Всегда свежий релиз smolagents
Даунтайм	Restart=always	Менее 1 мин простоя
Логи	Таблица agent_logs	Анализ в pgAdmin или Grafana

Готовые фичи и тюнинг под прод

Тюнинг - это когда агент не просто отвечает, а масштабируется. Добавь несколько агентов: один для парсинга, другой для генерации промптов. В PG таблица agents с полями id, status, last_run. Интеграция с Telegram-ботом на Node.js для уведомлений - опционально, но круто.

На слабом VPS юзай TransformersModel локально, на мощном - HF Inference. Тестировал на 4GB RAM: phi-3 летает. Фича 2026: LiteLLM для ротации моделей. Безопасность: whitelist инструментов, лимит токенов. Теперь твой AI-агент - полноценный worker на серваке.

Вот и вся автоматизация: от HF Spaces до cron + PG. Масштабируй под трафик, добавляй инструменты - и пет-проект вырастет в сервис. Осталось поэкспериментировать с multi-agent setups или E2B для zero-trust, но это уже на твой вкус.