This media is not supported in your browser
VIEW IN TELEGRAM
🌅 Доброе утро, друзья!
Как и обещал, на Хабре вышло продолжение серии про создание ИИ-ассистента на собственной базе знаний!
В новой статье я подробно рассказываю, как превратить консольного ассистента в полноценное веб-приложение с авторизацией и стримингом ответов от нейросети. Проект изначально задумывался максимально гибким — с возможностью легко масштабировать функциональность, добавлять пользователей и подключать новые модели.
🔐 В этой части я также показал новый подход к реализации системы JWT-авторизации — просто, прозрачно и удобно.
💡 Сейчас в проекте задействованы две нейросети: DeepSeek и ChatGPT. Всё работает через стриминг, интерфейс аккуратный и современный. Думаю, вам понравится.
📖 Читайте статью:
👉 Личный ИИ-ассистент на ваших данных. Часть 2: Веб-интерфейс, авторизация и стриминг ответов от ИИ
💻 Исходники проекта (вся логика из обеих частей):
🔗 GitHub: ChromaDBGPTDeepSeek — article_2
Как всегда, буду рад вашей поддержке, комментариям и обратной связи 🙌
Как и обещал, на Хабре вышло продолжение серии про создание ИИ-ассистента на собственной базе знаний!
В новой статье я подробно рассказываю, как превратить консольного ассистента в полноценное веб-приложение с авторизацией и стримингом ответов от нейросети. Проект изначально задумывался максимально гибким — с возможностью легко масштабировать функциональность, добавлять пользователей и подключать новые модели.
🔐 В этой части я также показал новый подход к реализации системы JWT-авторизации — просто, прозрачно и удобно.
💡 Сейчас в проекте задействованы две нейросети: DeepSeek и ChatGPT. Всё работает через стриминг, интерфейс аккуратный и современный. Думаю, вам понравится.
📖 Читайте статью:
👉 Личный ИИ-ассистент на ваших данных. Часть 2: Веб-интерфейс, авторизация и стриминг ответов от ИИ
💻 Исходники проекта (вся логика из обеих частей):
🔗 GitHub: ChromaDBGPTDeepSeek — article_2
Как всегда, буду рад вашей поддержке, комментариям и обратной связи 🙌
4🔥52👍15❤6✍2👏2😁2🤗1
👋 Друзья, привет!
Ловите небольшой лайфхак для тех, кто работает с FastAPI.
Иногда возникает необходимость скрыть отдельные методы из Swagger-документации (автоматически генерируемого интерфейса). Например, если у вас есть служебные эндпоинты, которые не стоит светить наружу.
Вот как это легко сделать 👇
💡 Ключевой параметр —
Пользуйтесь! 🚀
Ловите небольшой лайфхак для тех, кто работает с FastAPI.
Иногда возникает необходимость скрыть отдельные методы из Swagger-документации (автоматически генерируемого интерфейса). Например, если у вас есть служебные эндпоинты, которые не стоит светить наружу.
Вот как это легко сделать 👇
@router.post("/secret/", include_in_schema=False)
async def my_secret():
# Ваш код здесь
pass💡 Ключевой параметр —
include_in_schema=False. Он говорит FastAPI не включать метод в OpenAPI-схему, а значит, и в Swagger он не попадёт.Пользуйтесь! 🚀
2👍78❤15🔥11🐳3⚡1✍1👾1
This media is not supported in your browser
VIEW IN TELEGRAM
🔥 Интеграция Keycloak с FastAPI — просто о безопасности
Друзья, привет!
В честь 1 мая — Дня труда, решил не отдыхать, а поделиться полезной темой: интеграция Keycloak с FastAPI.
Для тех, кто не знаком: Keycloak — это мощная open-source система управления пользователями, авторизацией и SSO. Минимум кода — максимум защиты. Используется даже в банковских продуктах благодаря своей стабильности и гибкости.
📽 В видео, которое прикрепил к посту, вы увидите простой сценарий:
1️⃣ Пользователь с фронта перенаправляется на страницу авторизации Keycloak
2️⃣ Проходит регистрацию или вход
3️⃣ После успешного логина — возвращается в приложение с нужными токенами
🔗 Код из демонстрации доступен тут:
https://github.com/Yakvenalex/KeycloackFastApi
💡 Сейчас думаю собрать небольшой pet-проект — "хранилище мыслей" с авторизацией через Keycloak, и заодно оформить это в статью на Хабр. Если тема вам зайдёт — углубимся в детали: роли, группы, refresh токены, разграничение доступа и многое другое.
📬 Пишите в комментарии, если интересно. Будем разбирать вместе!
P.S. Всех с 1 мая! Хорошего настроения, и пусть труд будет в радость — особенно, если это труд по внедрению безопасных решений 😉
Друзья, привет!
В честь 1 мая — Дня труда, решил не отдыхать, а поделиться полезной темой: интеграция Keycloak с FastAPI.
Для тех, кто не знаком: Keycloak — это мощная open-source система управления пользователями, авторизацией и SSO. Минимум кода — максимум защиты. Используется даже в банковских продуктах благодаря своей стабильности и гибкости.
📽 В видео, которое прикрепил к посту, вы увидите простой сценарий:
1️⃣ Пользователь с фронта перенаправляется на страницу авторизации Keycloak
2️⃣ Проходит регистрацию или вход
3️⃣ После успешного логина — возвращается в приложение с нужными токенами
🔗 Код из демонстрации доступен тут:
https://github.com/Yakvenalex/KeycloackFastApi
💡 Сейчас думаю собрать небольшой pet-проект — "хранилище мыслей" с авторизацией через Keycloak, и заодно оформить это в статью на Хабр. Если тема вам зайдёт — углубимся в детали: роли, группы, refresh токены, разграничение доступа и многое другое.
📬 Пишите в комментарии, если интересно. Будем разбирать вместе!
P.S. Всех с 1 мая! Хорошего настроения, и пусть труд будет в радость — особенно, если это труд по внедрению безопасных решений 😉
5❤48👍42🔥19🎉3❤🔥2⚡1🍌1💋1
🚀 FastAPI + Keycloak: готовый проект и видеообзор
Друзья, всем привет!
Я подготовил для вас демо-проект, который показывает, как можно реализовать авторизацию с помощью Keycloak в связке с FastAPI в своем веб-приложении.
🔍 Чтобы проще разобраться, как всё работает, я записал короткий видеообзор — смотрите на удобной вам платформе:
📺 YouTube – https://www.youtube.com/watch?v=YyeB4NjWMHY&t=2s
📺 RuTube – https://rutube.ru/video/84b5021cadd5033c441ba43adcd166a8/
💡 Проект — это простое CRUD-приложение для заметок. Но основной акцент — на реализации авторизации через Keycloak.
Вот как работает процесс:
1. Пользователь переходит на страницу Keycloak (готовая форма авторизации/регистрации).
2. После входа происходит редирект обратно в ваше приложение с одноразовым кодом.
3. Приложение получает код и отправляет его обратно в Keycloak.
4. В ответ возвращаются access_token, refresh_token и id_token, которые можно сохранить в куках.
5. Далее эти токены используются для доступа к защищённым маршрутам.
🔐 Возможности Keycloak:
💎 формы регистрации/входа «из коробки»
💎 внутренняя база пользователей
💎 интеграция с email-рассылкой
💎 поддержка множества внешних провайдеров авторизации: GitHub, Google и многие другие.
🎥 В видео — демонстрация процесса. А более подробный разбор кода будет в моей статье на Хабре (скоро!).
📦 Исходный код проекта на GitHub:
🔗 github.com/Yakvenalex/KeycloackFastApi
Если остались вопросы или есть пожелания — пишите в комментариях!
Друзья, всем привет!
Я подготовил для вас демо-проект, который показывает, как можно реализовать авторизацию с помощью Keycloak в связке с FastAPI в своем веб-приложении.
🔍 Чтобы проще разобраться, как всё работает, я записал короткий видеообзор — смотрите на удобной вам платформе:
📺 YouTube – https://www.youtube.com/watch?v=YyeB4NjWMHY&t=2s
📺 RuTube – https://rutube.ru/video/84b5021cadd5033c441ba43adcd166a8/
💡 Проект — это простое CRUD-приложение для заметок. Но основной акцент — на реализации авторизации через Keycloak.
Вот как работает процесс:
1. Пользователь переходит на страницу Keycloak (готовая форма авторизации/регистрации).
2. После входа происходит редирект обратно в ваше приложение с одноразовым кодом.
3. Приложение получает код и отправляет его обратно в Keycloak.
4. В ответ возвращаются access_token, refresh_token и id_token, которые можно сохранить в куках.
5. Далее эти токены используются для доступа к защищённым маршрутам.
🔐 Возможности Keycloak:
🎥 В видео — демонстрация процесса. А более подробный разбор кода будет в моей статье на Хабре (скоро!).
📦 Исходный код проекта на GitHub:
🔗 github.com/Yakvenalex/KeycloackFastApi
Если остались вопросы или есть пожелания — пишите в комментариях!
Please open Telegram to view this post
VIEW IN TELEGRAM
YouTube
FastAPI + Keycloak: профессиональная авторизация без лишних сложностей (видео-обзор)
В этом видео я покажу вам, как быстро организовать профессиональную систему авторизации для вашего веб-приложения с помощью связки FastAPI и Keycloak. Вы увидите работающий пример приложения для заметок, где пользователи могут регистрироваться, входить в…
4❤🔥32🔥24👍14❤3🫡2😍1🎃1
Друзья, добрый день!
Рад поделиться с вами завершённым проектом на связке Keycloak + FastAPI, который подробно описан в моей новой статье на Хабре.
В статье я разбираю простой CRUD-приложение для заметок с реализацией полноценной авторизации через Keycloak - от формы входа и регистрации до работы с access и refresh токенами.
Что внутри статьи?
- Подробный разбор теоретических основ интеграции FastAPI с Keycloak.
- Особенности взаимодействия собственной системы с системой авторизации Keycloak.
- Пошаговое руководство по созданию безопасного и удобного механизма аутентификации и авторизации.
- Практический пример на реальном проекте, который будет полезен как новичкам, так и опытным разработчикам.
Статья называется:
«FastAPI + Keycloak: Простая и безопасная авторизация в веб-приложении на примере реального проекта» и уже доступна на Хабре.
Полезные материалы:
💎 Статья на Хабре: https://habr.com/ru/companies/amvera/articles/907990/
- Короткий видеообзор, где я показываю работу проекта на практике:
💎 YouTube: https://www.youtube.com/watch?v=YyeB4NjWMHY&t=2s
💎 RuTube: https://rutube.ru/video/84b5021cadd5033c441ba43adcd166a8/
💎 Исходный код проекта на GitHub: https://github.com/Yakvenalex/KeycloackFastApi
Если у вас возникнут вопросы или предложения - пишите в комментариях, буду рад помочь!
Рад поделиться с вами завершённым проектом на связке Keycloak + FastAPI, который подробно описан в моей новой статье на Хабре.
В статье я разбираю простой CRUD-приложение для заметок с реализацией полноценной авторизации через Keycloak - от формы входа и регистрации до работы с access и refresh токенами.
Что внутри статьи?
- Подробный разбор теоретических основ интеграции FastAPI с Keycloak.
- Особенности взаимодействия собственной системы с системой авторизации Keycloak.
- Пошаговое руководство по созданию безопасного и удобного механизма аутентификации и авторизации.
- Практический пример на реальном проекте, который будет полезен как новичкам, так и опытным разработчикам.
Статья называется:
«FastAPI + Keycloak: Простая и безопасная авторизация в веб-приложении на примере реального проекта» и уже доступна на Хабре.
Полезные материалы:
- Короткий видеообзор, где я показываю работу проекта на практике:
Если у вас возникнут вопросы или предложения - пишите в комментариях, буду рад помочь!
Please open Telegram to view this post
VIEW IN TELEGRAM
Хабр
FastAPI + Keycloak: Простая и безопасная авторизация в веб-приложении на примере реального проекта
Друзья, приветствую! Давно хотел рассказать вам о такой замечательной open-source технологии, как Keycloak на примере реального веб-приложения. Сегодня я расскажу вам простым и доступным языком о том,...
3👍39🔥21❤6🙏2🏆2👏1💋1
👋 Друзья, привет!
Хочу поделиться небольшой, но полезной наработкой для тех, кто работает с Telegram-ботами и отправкой изображений.
Ситуация:
У вас есть backend, на котором лежат изображения. Вы пытаетесь отправить их в чат бота с помощью
❌ Bad Request: wrong type of the web page content
Такое часто бывает, если:
* домен нестандартный (например, через туннель или локальный IP)
* сертификат Telegram не устраивает
* или просто он не может скачать файл напрямую.
🎯 Решение — скачать изображение вручную и отправить его как байты:
🛡 Это работает стабильно и безопасно. Независимо от особенностей хостинга или домена, Telegram получит реальный файл и всё отправится без ошибок.
Надеюсь, пригодится!
Хочу поделиться небольшой, но полезной наработкой для тех, кто работает с Telegram-ботами и отправкой изображений.
Ситуация:
У вас есть backend, на котором лежат изображения. Вы пытаетесь отправить их в чат бота с помощью
bot.send_photo, передавая прямую ссылку (image_url) — но Telegram отвечает чем-то вроде:❌ Bad Request: wrong type of the web page content
Такое часто бывает, если:
* домен нестандартный (например, через туннель или локальный IP)
* сертификат Telegram не устраивает
* или просто он не может скачать файл напрямую.
🎯 Решение — скачать изображение вручную и отправить его как байты:
import aiohttp
from aiogram.types import BufferedInputFile
async def send_photo_from_url(chat_id, image_url, caption=None, parse_mode="HTML"):
async with aiohttp.ClientSession() as session:
async with session.get(image_url) as resp:
if resp.status != 200:
raise Exception(f"Image load failed: {resp.status}")
img_bytes = await resp.read()
image = BufferedInputFile(img_bytes, filename="image.jpg")
await bot.send_photo(
chat_id=chat_id,
photo=image,
caption=caption,
parse_mode=parse_mode,
)
🛡 Это работает стабильно и безопасно. Независимо от особенностей хостинга или домена, Telegram получит реальный файл и всё отправится без ошибок.
Надеюсь, пригодится!
👍36🔥23❤7❤🔥1💘1
💭 А что, если пойти дальше?
Вместо того чтобы вручную возиться с кодом, почему бы не создать полноценный веб-интерфейс для отправки отложенных сообщений в Telegram — с поддержкой:
✨ форматированного текста
📸 изображений
📎 файлов
🔒 авторизации
🕒 планирования по времени
Всё это — через удобную, современную админку. Никаких команд в терминале — всё в пару кликов.
⚙️ Хочу рассказать, как реализовать такую систему на базе FastAPI, Aiogram 3 и SQLAlchemy, с гибкой очередью сообщений и полной готовностью к продакшену. Авторизацию можно будет снова сделать через Keycloak.
Будете ждать такую статью?
Вместо того чтобы вручную возиться с кодом, почему бы не создать полноценный веб-интерфейс для отправки отложенных сообщений в Telegram — с поддержкой:
✨ форматированного текста
📸 изображений
📎 файлов
🔒 авторизации
🕒 планирования по времени
Всё это — через удобную, современную админку. Никаких команд в терминале — всё в пару кликов.
⚙️ Хочу рассказать, как реализовать такую систему на базе FastAPI, Aiogram 3 и SQLAlchemy, с гибкой очередью сообщений и полной готовностью к продакшену. Авторизацию можно будет снова сделать через Keycloak.
Будете ждать такую статью?
2🔥124👍37❤11🤩3🤪3👎1🎄1
Генерация SSH-ключа на VPS и привязка к GitHub — быстро и просто 🚀
Чтобы работать с GitHub с VPS удобно и безопасно, без постоянного ввода логина и пароля, рекомендую настроить SSH-доступ. Это просто:
1️⃣ Создаём SSH-ключ (рекомендуется Ed25519):
Откройте терминал на сервере и выполните:
2️⃣ Используем стандартный путь (\~/.ssh/id\_ed25519):
Нажмите Enter при запросе пути. При желании задайте пароль — или оставьте пустым для удобства.
3️⃣ Копируем публичный ключ:
4️⃣ Добавляем ключ в GitHub:
GitHub → Settings → SSH and GPG keys → New SSH key
Вставьте ключ, дайте название (например,
5️⃣ Проверяем подключение:
Если увидите сообщение вроде “Hi username! You've successfully authenticated” — всё работает ✅
Теперь можно клонировать репозитории по SSH:
Важно! Убедитесь, что ссылки на репозитории в ваших проектах тоже используют SSH, а не HTTPS. Это можно проверить и изменить так:
🔄 Проверить текущую ссылку:
🔧 Изменить на SSH-ссылку:
Теперь вы готовы работать с репозиториями без лишней головной боли — быстро, безопасно и без постоянного ввода логина/пароля 💻🔐
Чтобы работать с GitHub с VPS удобно и безопасно, без постоянного ввода логина и пароля, рекомендую настроить SSH-доступ. Это просто:
1️⃣ Создаём SSH-ключ (рекомендуется Ed25519):
Откройте терминал на сервере и выполните:
ssh-keygen -t ed25519 -C "ваш_email@example.com"
2️⃣ Используем стандартный путь (\~/.ssh/id\_ed25519):
Нажмите Enter при запросе пути. При желании задайте пароль — или оставьте пустым для удобства.
3️⃣ Копируем публичный ключ:
cat ~/.ssh/id_ed25519.pub
4️⃣ Добавляем ключ в GitHub:
GitHub → Settings → SSH and GPG keys → New SSH key
Вставьте ключ, дайте название (например,
My VPS) и сохраните.5️⃣ Проверяем подключение:
ssh -T git@github.com
Если увидите сообщение вроде “Hi username! You've successfully authenticated” — всё работает ✅
Теперь можно клонировать репозитории по SSH:
git clone git@github.com:username/repository.git
Важно! Убедитесь, что ссылки на репозитории в ваших проектах тоже используют SSH, а не HTTPS. Это можно проверить и изменить так:
🔄 Проверить текущую ссылку:
git remote -v
🔧 Изменить на SSH-ссылку:
git remote set-url origin git@github.com:username/repository.git
Теперь вы готовы работать с репозиториями без лишней головной боли — быстро, безопасно и без постоянного ввода логина/пароля 💻🔐
👍25🔥9❤5🎉1
Полное руководство по настройке CI/CD для проектов на VueJS3 и FastAPI
Я подготовил небольшую, но ёмкую инструкцию по работе с технологией GitHub Actions. Если кратко, эта технология позволяет при пуше в репозиторий на GitHub автоматически запускать процессы, которые обновляют ваше приложение на VPS-сервере.
В руководстве я описал два простых примера: один - с использованием systemd для FastAPI, другой - с чистым Nginx для VueJS3. При этом GitHub Actions отлично подходит и для более сложных связок, например, с Docker.
Старался писать максимально доступно и без лишней «воды», так что заходите, кому интересно!
Полная инструкция доступна по ссылке: yakvenalex.ru/ru/all_technology/ci-cd-guide
Я подготовил небольшую, но ёмкую инструкцию по работе с технологией GitHub Actions. Если кратко, эта технология позволяет при пуше в репозиторий на GitHub автоматически запускать процессы, которые обновляют ваше приложение на VPS-сервере.
В руководстве я описал два простых примера: один - с использованием systemd для FastAPI, другой - с чистым Nginx для VueJS3. При этом GitHub Actions отлично подходит и для более сложных связок, например, с Docker.
Старался писать максимально доступно и без лишней «воды», так что заходите, кому интересно!
Полная инструкция доступна по ссылке: yakvenalex.ru/ru/all_technology/ci-cd-guide
🔥37👍12❤7⚡2🍾2🤪1
Простой способ скрывать автоматизацию браузера при работе с Playwright
Если вы используете Playwright для автоматизации браузера и хотите, чтобы сайты не определяли, что вы — бот, есть простой и эффективный трюк.
Шаг 1. Установка Playwright и драйверов
Шаг 2. Пример скрипта с обходом детекции автоматизации
Почему это работает?
- Аргумент
- Запуск браузера с этим параметром помогает скрыть автоматизацию от сайтов, которые пытаются определить ботов.
- Сайт intoli.com отлично подходит для проверки, видит ли сайт, что вы используете автоматизацию.
Этот простой приём помогает значительно снизить риск блокировок и детекций при автоматизации через Playwright. Попробуйте и убедитесь сами!
Если вы используете Playwright для автоматизации браузера и хотите, чтобы сайты не определяли, что вы — бот, есть простой и эффективный трюк.
Шаг 1. Установка Playwright и драйверов
pip install playwright==1.52.0 # или более новую версию
playwright install # установка всех драйверов
# или для конкретного браузера:
playwright install chromium # драйвер для Chrome/Chromium
Шаг 2. Пример скрипта с обходом детекции автоматизации
import asyncio
from playwright.async_api import async_playwright
async def main():
async with async_playwright() as p:
browser = await p.chromium.launch(
headless=False,
channel="chrome",
args=["--start-maximized", "--disable-blink-features=AutomationControlled"],
)
context = await browser.new_context(no_viewport=True)
page = await context.new_page()
await page.goto("https://intoli.com/blog/not-possible-to-block-chrome-headless/chrome-headless-test.html")
await page.wait_for_timeout(5000) # пауза 5 секунд для просмотра результата
await context.close()
if __name__ == "__main__":
asyncio.run(main())
Почему это работает?
- Аргумент
--disable-blink-features=AutomationControlled отключает встроенную в Chromium функцию, которая обычно выдаёт факт автоматизации (например, свойство navigator.webdriver).- Запуск браузера с этим параметром помогает скрыть автоматизацию от сайтов, которые пытаются определить ботов.
- Сайт intoli.com отлично подходит для проверки, видит ли сайт, что вы используете автоматизацию.
Этот простой приём помогает значительно снизить риск блокировок и детекций при автоматизации через Playwright. Попробуйте и убедитесь сами!
1❤26👍24🔥16🎄1🙉1
Легкий путь в Python
💭 А что, если пойти дальше? Вместо того чтобы вручную возиться с кодом, почему бы не создать полноценный веб-интерфейс для отправки отложенных сообщений в Telegram — с поддержкой: ✨ форматированного текста 📸 изображений 📎 файлов 🔒 авторизации 🕒 планирования…
Друзья, надеюсь соскучились. Скоро к вам вернусь. Надеюсь, что следующий месяц будет свободнее. На очереди, как и говорил, проект с веб-интерфейсом для телеграмм бота. Постараюсь к концу следующей недели выйти с новым материалом на Хабре.
🔥64❤15👍10❤🔥8👀2🤯1😱1
🧵 Бывает, нужна
В таких случаях на помощь приходит
Это отличный способ создать модель на лету, особенно когда нужно:
* собрать фильтр для DAO,
* подготовить временную обёртку под данные,
* протестировать какой-то кусок бизнес-логики без лишней бюрократии.
🛠 Ниже — 3 удобных способа использования
1. 📦 Обычное создание класса + отдельный вызов
✅ Подходит, если модель будет использоваться более одного раза
🧠 Имя
2. ⚡️ Создание и вызов — в одной строке, с именем
✅ Удобно, если модель используется один раз, но вы всё же хотите, чтобы она имела осмысленное имя (для дебага или логирования).
3. 🎭 Максимально лаконично — без имени
✅ Идеально для разовых задач, тестов, временных скриптов
⚠️ Но без имени будет сложнее отследить, если модель "взорвётся" в логах или ошибках.
💡 Напоминаю:
👨💻 Используйте этот приём, чтобы писать чище, быстрее и без лишнего шума в кодовой базе.
pydantic-модель… но лезть в schemas.py лень, да и незачемВ таких случаях на помощь приходит
create_model из Pydantic 🧙♂️Это отличный способ создать модель на лету, особенно когда нужно:
* собрать фильтр для DAO,
* подготовить временную обёртку под данные,
* протестировать какой-то кусок бизнес-логики без лишней бюрократии.
🛠 Ниже — 3 удобных способа использования
create_model1. 📦 Обычное создание класса + отдельный вызов
from pydantic import create_model
FilterModel = create_model('FilterModel', id=(int, ...))
filter_model = FilterModel(id=child_id)
✅ Подходит, если модель будет использоваться более одного раза
🧠 Имя
'FilterModel' здесь не просто строка — оно будет видно в логах, исключениях и IDE-подсказках, что может сильно облегчить отладку.2. ⚡️ Создание и вызов — в одной строке, с именем
from pydantic import create_model
filter_model = create_model('FilterModel', id=(int, ...))(id=child_id)
✅ Удобно, если модель используется один раз, но вы всё же хотите, чтобы она имела осмысленное имя (для дебага или логирования).
3. 🎭 Максимально лаконично — без имени
from pydantic import create_model
filter_model = create_model('', id=(int, ...))(id=child_id)
✅ Идеально для разовых задач, тестов, временных скриптов
⚠️ Но без имени будет сложнее отследить, если модель "взорвётся" в логах или ошибках.
💡 Напоминаю:
create_model создаёт полноценную BaseModel, так что она полностью совместима с остальной экосистемой Pydantic — включая .model_dump(), валидацию, .model_json(), .model_fields, и так далее.👨💻 Используйте этот приём, чтобы писать чище, быстрее и без лишнего шума в кодовой базе.
👍23❤5🔥4⚡2👎1🍌1🤝1🫡1
🔧 Git: "Не могу запушить!" - Простое решение конфликта веток
😱 Что случилось?
Вы сделали коммит, пытаетесь сделать
Причина: Пока вы работали, кто-то другой уже запушил свои изменения в эту же ветку.
🎯 Простое и безопасное решение
Шаг 1: Скачиваем новые изменения
✨ Если конфликтов НЕТ:
Git выведет что-то вроде:
Переходите сразу к Шагу 5! 🚀
Шаг 2: Если появились конфликты
Git покажет что-то вроде:
Шаг 3: Решаем конфликты (если они есть)
1. Открываем файл с конфликтом
2. Ищем строки с
3. Оставляем нужный код, удаляем служебные символы
4. Сохраняем файл
Шаг 4: Завершаем (только при конфликтах)
Шаг 5: Пушим результат
✅ Готово!
Ваши изменения теперь в репозитории поверх всех остальных.
🆘 Если запаниковали
💡 Главное: не паникуйте! Эта ошибка - норма в командной работе.
😱 Что случилось?
Вы сделали коммит, пытаетесь сделать
git push и получаете ошибку (вместо main имя ветки в которую вы пушили):! [rejected] main -> main (non-fast-forward)
Причина: Пока вы работали, кто-то другой уже запушил свои изменения в эту же ветку.
🎯 Простое и безопасное решение
Шаг 1: Скачиваем новые изменения
git pull --rebase origin main
Эта команда скачает чужие изменения и попытается поставить ваш коммит поверх них
✨ Если конфликтов НЕТ:
Git выведет что-то вроде:
Successfully rebased and updated refs/heads/main.
Успешно перемещён и обновлён refs/heads/main.
Переходите сразу к Шагу 5! 🚀
Шаг 2: Если появились конфликты
Git покажет что-то вроде:
CONFLICT (content): Merge conflict in file.py
Шаг 3: Решаем конфликты (если они есть)
1. Открываем файл с конфликтом
2. Ищем строки с
<<<<<<<, =======, >>>>>>>3. Оставляем нужный код, удаляем служебные символы
4. Сохраняем файл
Шаг 4: Завершаем (только при конфликтах)
git add .
git rebase --continue
Шаг 5: Пушим результат
git push origin main
✅ Готово!
Ваши изменения теперь в репозитории поверх всех остальных.
🆘 Если запаниковали
git rebase --abort
Вернет все как было до начала операции
💡 Главное: не паникуйте! Эта ошибка - норма в командной работе.
2🔥36👍14❤12⚡2😍2👏1🍌1
🚀 FastAPI app.state: правильное управление глобальным состоянием
app.state в FastAPI — это встроенный механизм для хранения данных, которые должны быть доступны на протяжении всего жизненного цикла приложения.
📝 Базовый синтаксис
🔧 Использование в зависимостях
⚡️ Преимущества app.state
✅ Типобезопасность — можно добавить типизацию через Pydantic
✅ Автоматическое управление — создание при старте, очистка при завершении
✅ Доступность везде — через Request object в любой части приложения
✅ Производительность — нет overhead на создание подключений в каждом запросе
💡 Лучшие практики
🔸 Используйте app.state для тяжелых ресурсов (пулы БД, ML модели, клиенты API)
🔸 Не храните пользовательские данные — только глобальные ресурсы
🔸 Всегда закрывайте ресурсы в блоке shutdown
🔸 Создавайте отдельные зависимости для каждого ресурса
Старый синтаксис с
app.state в FastAPI — это встроенный механизм для хранения данных, которые должны быть доступны на протяжении всего жизненного цикла приложения.
📝 Базовый синтаксис
from fastapi import FastAPI, Depends, Request
from contextlib import asynccontextmanager
# Современный синтаксис жизненного цикла (FastAPI 0.93+)
@asynccontextmanager
async def lifespan(app: FastAPI):
# Startup
app.state.database_pool = await create_db_pool()
app.state.redis_client = await create_redis_client()
app.state.ml_model = load_ml_model()
yield # Приложение работает
# Shutdown
await app.state.database_pool.close()
await app.state.redis_client.close()
app = FastAPI(lifespan=lifespan)
🔧 Использование в зависимостях
# Зависимость для получения данных из app.state
def get_db_pool(request: Request):
return request.app.state.database_pool
def get_redis(request: Request):
return request.app.state.redis_client
# Использование в эндпоинтах
@app.get("/users/{user_id}")
async def get_user(
user_id: int,
db_pool = Depends(get_db_pool),
redis = Depends(get_redis)
):
# Сначала проверяем кеш
cached = await redis.get(f"user:{user_id}")
if cached:
return json.loads(cached)
# Если нет в кеше, идем в БД
async with db_pool.acquire() as conn:
user = await conn.fetchrow("SELECT * FROM users WHERE id = $1", user_id)
await redis.setex(f"user:{user_id}", 300, json.dumps(dict(user)))
return user
⚡️ Преимущества app.state
✅ Типобезопасность — можно добавить типизацию через Pydantic
✅ Автоматическое управление — создание при старте, очистка при завершении
✅ Доступность везде — через Request object в любой части приложения
✅ Производительность — нет overhead на создание подключений в каждом запросе
💡 Лучшие практики
🔸 Используйте app.state для тяжелых ресурсов (пулы БД, ML модели, клиенты API)
🔸 Не храните пользовательские данные — только глобальные ресурсы
🔸 Всегда закрывайте ресурсы в блоке shutdown
🔸 Создавайте отдельные зависимости для каждого ресурса
Старый синтаксис с
@app.on_event("startup") устарел с версии 0.93. Используйте lifespan!👍29🔥10❤5❤🔥2⚡2💘2🦄2😁1
🧠💾 Если коротко, то я подключил нейронку напрямую к базе данных
Теперь вместо написания SQL запросов я просто говорю Claude человеческим языком:
💬 "Покажи всех сотрудников из отдела Engineering с их зарплатами"
💬 "Создай отчет по проектам с бюджетами"
💬 "Найди самых загруженных разработчиков"
А он сам формирует SQL, выполняет запрос и красиво выводит результат ✨
Рассказать вам как это работает? 🤔
Теперь вместо написания SQL запросов я просто говорю Claude человеческим языком:
💬 "Покажи всех сотрудников из отдела Engineering с их зарплатами"
💬 "Создай отчет по проектам с бюджетами"
💬 "Найди самых загруженных разработчиков"
А он сам формирует SQL, выполняет запрос и красиво выводит результат ✨
Рассказать вам как это работает? 🤔
🔥125👍38❤🔥5❤3👏3🤯2😱2🙈2🙊1
Легкий путь в Python
🧠💾 Если коротко, то я подключил нейронку напрямую к базе данных Теперь вместо написания SQL запросов я просто говорю Claude человеческим языком: 💬 "Покажи всех сотрудников из отдела Engineering с их зарплатами" 💬 "Создай отчет по проектам с бюджетами" 💬…
FastAPI + MCP + LLM как сервис — звучит как неплохая идея для статьи, не правда ли?
6🔥113👍34💯16🤩2🎄2
🚀 MCP + Локальная Llama: Файловая система под контролем ИИ
А вот ещё один пример интеграции MCP, но на этот раз уже с локальной нейросетью Meta-Llama-3.1-8B и MCP modelcontextprotocol/server-filesystem!
На скриншоте видно, как Llama успешно:
- 🤖 Понимает команду на русском языке
- 🔧 Выбирает правильный инструмент
- ✅ Создаёт файл
- 📁 Подтверждает выполнение операции
Что особенно круто:
- Никаких API-ключей — всё работает локально
- Llama понимает естественный язык и переводит в MCP-команды
- Полный контроль над файловой системой через стандартизированный протокол
Стек: Python + MCP + Ollama + @modelcontextprotocol/server-filesystem
Model Context Protocol действительно упрощает интеграцию ИИ с внешними инструментами. Один протокол — множество возможностей!
А вот ещё один пример интеграции MCP, но на этот раз уже с локальной нейросетью Meta-Llama-3.1-8B и MCP modelcontextprotocol/server-filesystem!
На скриншоте видно, как Llama успешно:
- 🤖 Понимает команду на русском языке
- 🔧 Выбирает правильный инструмент
fs_write_file- ✅ Создаёт файл
ex.py с HTTP-запросом к python.org- 📁 Подтверждает выполнение операции
Что особенно круто:
- Никаких API-ключей — всё работает локально
- Llama понимает естественный язык и переводит в MCP-команды
- Полный контроль над файловой системой через стандартизированный протокол
Стек: Python + MCP + Ollama + @modelcontextprotocol/server-filesystem
Model Context Protocol действительно упрощает интеграцию ИИ с внешними инструментами. Один протокол — множество возможностей!
🔥31👍16❤4☃1😇1🤪1
🚀 Создаем AI агента с доступом к файловой системе за 5 минут!
Недавно попробовал Model Context Protocol (MCP) от Anthropic с OpenAI — и это просто магия! Теперь GPT может работать с вашими файлами напрямую.
📦 Быстрая установка
💻 Минимальный код
✨ Что происходит под капотом?
В этом примере мы подключили к агенту MCP filesystem server, который дает GPT возможность:
- 📁 Читать и создавать файлы
- 📋 Просматривать содержимое папок
- 🔍 Искать файлы по содержимому
- ✏️ Редактировать код напрямую
🎯 Результат
Агент автоматически:
1. Создает файл
2. Пишет рабочий код для OpenAI API
3. Сохраняет его в файловую систему
Никакого копирования кода вручную — AI делает всё сам!
🔥 Возможности
- Автоматизация: Создание целых проектов одной командой
- Рефакторинг: "Отрефактори все .py файлы в папке"
- Документация: "Создай README для этого проекта"
- Тестирование: "Напиши тесты для всех модулей"
MCP — это будущее AI агентов. Теперь они не просто болтают, а реально работают с вашими данными! 🤖
Другие MCP сервера подключаются по такой-же логике.
P.S. Пока локальные модели с которыми я работал не позволили получить такого-же качественного профита от взаимодействия с MCP, но, возможно, вопрос в мощности железа и качестве самих локальных LLM.
Недавно попробовал Model Context Protocol (MCP) от Anthropic с OpenAI — и это просто магия! Теперь GPT может работать с вашими файлами напрямую.
📦 Быстрая установка
pip install openai-agents
💻 Минимальный код
import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStdio
import os
os.environ["OPENAI_API_KEY"] = "sk-proj-..."
async def main():
async with MCPServerStdio(
params={
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "."],
}
) as mcp_server:
agent = Agent(
name="Assistant",
instructions="Ты ассистент, который может работать с файлами через инструменты.",
mcp_servers=[mcp_server]
)
result = await Runner.run(
agent,
"Создай файл test.py с примером get запроса к серверу openai"
)
print(result.final_output)
asyncio.run(main())
✨ Что происходит под капотом?
В этом примере мы подключили к агенту MCP filesystem server, который дает GPT возможность:
- 📁 Читать и создавать файлы
- 📋 Просматривать содержимое папок
- 🔍 Искать файлы по содержимому
- ✏️ Редактировать код напрямую
🎯 Результат
Агент автоматически:
1. Создает файл
test.py2. Пишет рабочий код для OpenAI API
3. Сохраняет его в файловую систему
Никакого копирования кода вручную — AI делает всё сам!
🔥 Возможности
- Автоматизация: Создание целых проектов одной командой
- Рефакторинг: "Отрефактори все .py файлы в папке"
- Документация: "Создай README для этого проекта"
- Тестирование: "Напиши тесты для всех модулей"
MCP — это будущее AI агентов. Теперь они не просто болтают, а реально работают с вашими данными! 🤖
Другие MCP сервера подключаются по такой-же логике.
P.S. Пока локальные модели с которыми я работал не позволили получить такого-же качественного профита от взаимодействия с MCP, но, возможно, вопрос в мощности железа и качестве самих локальных LLM.
🔥27❤10⚡2🎉1🏆1💋1