# Hypn0 (HypnoSVG)

<p align="center">
  <a href="README.md">English</a> •
  <b>Русский</b>
</p>

---

Процедурный генератор анимированной векторной полутоновой графики (halftone SVG). Превращает растровые изображения в масштабируемый векторный арт из пульсирующих геометрических матриц.

[![Python 3.14](https://img.shields.io/badge/Python-3.14-blue)](https://python.org)
[![Django 6.0](https://img.shields.io/badge/Django-6.0-green)](https://djangoproject.com)
[![License: PolyForm NC / CC0](https://img.shields.io/badge/License-PolyForm_NC_%2F_CC0-blue)](LICENSE.md)
[![Static Badge](https://img.shields.io/badge/ОРИГИНАЛ-git.cube2.ru-green)](https://git.cube2.ru/erjemin/2026-hypn0-site)

---

> ### 🐸 Заметка о теме и интерфейсе (Лор vs Продакшен)
> **Hypn0** оформлен в шутливой научно-фантастической стилистике по мотивам *Футурамы*, **Гипножабы**, Мозговых Слизней и бюрократии Нового Нью-Йорка.
> 
> * **Интуитивный визуальный интерфейс:** Понимать термины лора или владеть конкретным языком необязательно — все параметры генератора (выбор фигур, плотность сетки, ползунки анимаций, настройка палитры) полностью визуальны, интерактивны и интуитивно понятны.
> * **Готовность к продакшену:** Несмотря на игривый вайб, генерируемый SVG-код является чистым, легковесным и полностью готовым к использованию в продакшене (веб-дизайн, UI/UX, маркетинг, плоттерная и лазерная резка).

---

## Что это и зачем

**Hypn0** раскладывает фото, логотипы и графику на процедурные геометрические фигуры (круги, кольца, ромбы, снежинки, матрицы «0/1», звезды, сердца) с индивидуальной фазовой CSS-анимацией.

На выходе — чистый, легковесный `.svg` (20–50 КБ), работающий нативно без JavaScript на любых экранах.

### Где применять:
- **UI/UX и веб-дизайн:** Легкие анимированные прелоадеры, Hero-фоны лендингов, экраны 404 и Dark Mode подложки (вместо тяжелых GIF и видео).
- **Маркетинг и SMM:** Динамические баннеры, CTA-плашки, обложки треков/подкастов и YouTube-превью, пробивающие баннерную слепоту.
- **Геймдев и Sci-Fi:** Процедурные терминалы, радары, сканеры, силовые поля и HUD-интерфейсы.
- **VJing и стриминг:** Оверлеи для OBS/Twitch и бесшовные визуальные петли (VJ loops) для сцены.
- **ЧПУ и полиграфия:** Векторные контуры для лазерной гравировки, плоттерной резки и шелкографии/мерча.

---

## Ключевые возможности

- **12+ процедурных форм:** круги, кольца, ромбы, гексагоны, снежинки, бинарный код, кресты, звезды, сердца.
- **Полный контроль растеризации:** плотность сетки, радиус, пороги отсечения, дуотоновые и инверсные палитры.
- **Чистый CSS @keyframes:** дыхание, мерцание, волны и вращение без нагрузки на CPU.
- **Галерея сообщества:** трехуровневая система отбора (Инкубатор -> Выбор Мозгового Слизня -> Золотой фонд) с гравитационным алгоритмом рейтинга.

---

## Пример работы

![Пример генерации](public/static/img/thinking.svg)

---

## Документация и ссылки

- **Frontend сборка:** [frontend-assembly/README.md](frontend-assembly/README.md) — сборка Alpine.js, Tailwind CSS, HTMX.
- **ИИ-интеграция:** [public/llms.txt](public/llms.txt) — контекст для LLM и агентных систем.
- **Безопасность и приватность:** [SECURITY.md](SECURITY.md) — Zero-PII, правила отслеживания и защита от накруток.
- **Планы и архитектура:** [_blueprint/plan-draft.md](_blueprint/plan-draft.md).
- **Предыстория:** CLI-утилита [2026-image-hatftone-effect](https://git.cube2.ru/erjemin/2026-image-hatftone-effect).
- **Участие в разработке:** [CONTRIBUTING.md](CONTRIBUTING.md) — стандарты кода и правила для контрибьюторов.
- **Кодекс поведения:** [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) — стандарты взаимодействия в сообществе.

---

## Лицензия

- **Исходный код:** [PolyForm Noncommercial 1.0.0](LICENSE.md) (свободное некоммерческое использование).
- **Сгенерированные SVG:** [CC0 1.0 Universal](LICENSE.md) (свободное использование в любых личных и коммерческих проектах).