Open source · Юнидока

github.com/unidoka/amorfa

Amorfa.
Fullstack за часы, а не недели.

AI-оптимизированный fullstack-фреймворк: FastAPI, Next.js, PostgreSQL и Valkey — всё подключено, задокументировано и самохостится. Клонируйте репозиторий и начинайте строить то, что действительно хотели.

Apache 2.0 LicenseAmorfa UIDocker ComposeAI-optimized

Что внутри

Всё, что нужно для продакшена — и ничего лишнего.

Запуск за часы

Скаффолд со всем включённым: авторизация, БД, кэш, прокси и CI уже настроены. Клонируй, отредактируй .env, запускай.

AI-first структура

Каждый файл несёт LLM-читаемый контекст. Конфиг Repomix, .agents/skills и задокументированное дерево файлов — из коробки.

Fullstack, честно

FastAPI + SQLAlchemy 2.0 + Alembic на бэкенде. Next.js 16 App Router + Tailwind v4 на фронтенде. Один репозиторий.

Ноль lock-in

Никаких SaaS-панелей. Docker Compose, Traefik, Postgres, Valkey — всё самохостится на одном VPS.

Готов к микросервисам

Папка /services — это конвенция, а не ограничение. Разделяйте на микросервисы, когда это реально нужно.

Задокументированные дефолты

Комментарии объясняют «почему», а не «что». JWT-ротация, OTP, rate limiting и email-флоу — уже подключены.

Структура

Один репозиторий — два сервиса.

Монорепо по умолчанию: бэкенд и фронтенд рядом, но изолированы. Разделение на микросервисы — вопрос одного docker-compose, а не переписывания.

Каждый файл несёт контекст для LLM-агента: комментарии, структура, .agents/skills. Repomix-конфиг собирает весь проект в один читаемый документ — можно скармливать модели целиком.

$ git clone https://github.com/unidoka/amorfa
/
├── backend/
│   ├── services/
│   │   └── main-service/          # FastAPI-сервис
│   ├── env.example                # .env-переменные бэкенда
│   ├── Dockerfile
│   └── docker-compose.yml
├── website/
│   ├── app/                       # Next.js App Router
│   ├── components/                # shadcn/ui + кастомные
│   ├── env.example
│   ├── Dockerfile
│   └── docker-compose.yml
├── .agents/skills/                # LLM-контекст для агента
├── env.example                    # общие .env-переменные
├── docker-compose.yml             # топовый compose
└── README.md

Стек

Современный, простой, надёжный.

Python 3.12FastAPISQLAlchemy 2.0AlembicPostgreSQL 15Valkey / RedisNext.js 16React 19Tailwind CSS v4TypeScriptDockerTraefik

Быстрый старт

Три команды до работающего приложения.

01

Клонировать и настроить

$ git clone https://github.com/unidoka/amorfa && cd amorfa && cp .env.example .env
02

Поднять контейнеры

$ docker compose up -d --build
03

Применить миграции

$ docker exec -it main-service alembic upgrade head

Открытый исходный код.
Ваш ход.

Форкайте, дописывайте, присылайте PR. Amorfa живёт, пока её используют.