NeuroCad

English | Русский

NeuroCad is a lightweight platform for building websites and web apps on FastAPI. It includes a visual editor, an LLM editor, a modular system, and ready-to-use authentication.

Features

🎨 Visual editor — GrapesJS, drag-and-drop blocks, StyleManager
⚡ LLM editor — edit pages via DeepSeek, chat with history
📦 Modular system — modules defined in app/*.json
🔐 Auth — superadmin, roles, password reset
🖼️ Media library — image upload and storage
🗄️ SQLite out of the box — no setup required

Quick start

pip install neurocad

mkdir my_project && cd my_project
neurocad run

Open http://127.0.0.1:8000 — login admin, password admin.

Installation

Requirements: Python 3.10+, pip.

pip install neurocad

Usage

CLI

neurocad run        # start the server (uvicorn)

neurocad init creates the following structure:

my_project/
├── app/            # modules (JSON page configs)
├── base/           # SQLite database
├── core/           # Core
├── log/            # logs
├── media/          # uploaded files
├── static/         # static files
├── mig/            # migrations
├── .env
└── main.py

As a library

from neurocad import NeuroCad

app = NeuroCad()

Configuration

Create a .env file in your project root:

SQLITE_URL=sqlite+aiosqlite:///base/neurocad.db
SQLITE_URL_SYNC=sqlite:///base/neurocad.db

SECRET_KEY=change-me-in-production
SUPERADMIN_LOGIN=admin
SUPERADMIN_PASSWORD=admin

APP_HOST=127.0.0.1
APP_PORT=8000

# LLM (DeepSeek)
LLM_PROVIDER=deepseek
DEEPSEEK_API_KEY=sk-...
DEEPSEEK_MODEL=deepseek-flash

LLM editor

The ⚡ button in the page toolbar opens the LLM editor:

left — page preview;
center — current page preview;
right — chat with DeepSeek.

Describe what you want to change — the model returns HTML, which is applied to the preview and saved on the server. Chat history is stored per page.

Requires a DeepSeek API key in .env (DEEPSEEK_API_KEY).

Visual editor

The ✏ button opens GrapesJS:

block library on the left;
canvas in the center;
StyleManager on the right.

Changes are saved via /core/engine/lib/word/{id}.

Project structure

neurocad/
├── core/                  # core
│   ├── auth/              # authentication
│   ├── engine/            # engine, modules, editors
│   │   ├── lib/           # base components
│   │   │   ├── base/      # page skeleton
│   │   │   ├── word/      # page content + editors
│   │   │   │   ├── editor/    # GrapesJS
│   │   │   │   └── llm/       # LLM editor
│   │   │   ├── pages/     # article list
│   │   │   └── nav/       # navigation
│   │   └── mod/           # built-in modules (JSON)
│   └── models/            # SQLAlchemy models
├── utils/                 # utilities
│   ├── llm/               # LLM clients (DeepSeek)
│   ├── sqlite.py          # DB connection
│   └── static.py          # static files serving
├── alembic/               # migrations
├── cli.py                 # CLI
└── app.py                 # FastAPI factory

License

MIT. See LICENSE.

Русский

NeuroCad — лёгкая платформа для создания сайтов и веб-приложений на FastAPI. Включает визуальный редактор, LLM-редактор, модульную систему и готовую авторизацию.

Возможности

🎨 Визуальный редактор — GrapesJS, drag-and-drop блоков, StyleManager
⚡ LLM-редактор — правки страниц через DeepSeek, чат с историей
📦 Модульная система — модули описываются в app/*.json
🔐 Авторизация — суперадмин, роли, восстановление пароля
🖼️ Медиатека — загрузка и хранение изображений
🗄️ SQLite из коробки — не требует настройки

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

pip install neurocad

mkdir my_project && cd my_project
neurocad run

Откройте http://127.0.0.1:8000 — логин admin, пароль admin.

Установка

Требования: Python 3.10+, pip.

pip install neurocad

Использование

CLI

neurocad run        # запустить сервер (uvicorn)

neurocad init создаёт структуру:

my_project/
├── app/            # модули (JSON-конфиги страниц)
├── base/           # SQLite БД
├── core/           # для переопределения core
├── log/            # логи
├── media/          # загруженные файлы
├── static/         # статика
├── mig/            # миграции
├── .env
└── main.py

Как библиотека

from neurocad import NeuroCad

app = NeuroCad()

Конфигурация

Создайте .env в корне проекта:

SQLITE_URL=sqlite+aiosqlite:///base/neurocad.db
SQLITE_URL_SYNC=sqlite:///base/neurocad.db

SECRET_KEY=change-me-in-production
SUPERADMIN_LOGIN=admin
SUPERADMIN_PASSWORD=admin

APP_HOST=127.0.0.1
APP_PORT=8000

# LLM (DeepSeek)
LLM_PROVIDER=deepseek
DEEPSEEK_API_KEY=sk-...
DEEPSEEK_MODEL=deepseek-flash

LLM-редактор

Кнопка ⚡ в тулбаре страницы открывает LLM-редактор:

слева — превью страницы;
в центре — превью текущей страницы;
справа — чат с DeepSeek.

Опишите, что нужно изменить — модель вернёт HTML, он применится к превью и сохранится на сервере. История чата сохраняется по каждой странице.

Для работы нужен ключ DeepSeek в .env (DEEPSEEK_API_KEY).

Визуальный редактор

Кнопка ✏ открывает GrapesJS:

библиотека блоков слева;
canvas в центре;
StyleManager справа.

Изменения сохраняются через /core/engine/lib/word/{id}.

Структура проекта

neurocad/
├── core/                  # ядро
│   ├── auth/              # авторизация
│   ├── engine/            # движок, модули, редакторы
│   │   ├── lib/           # базовые компоненты
│   │   │   ├── base/      # каркас страницы
│   │   │   ├── word/      # контент страницы + редакторы
│   │   │   │   ├── editor/    # GrapesJS
│   │   │   │   └── llm/       # LLM-редактор
│   │   │   ├── pages/     # список статей
│   │   │   └── nav/       # навигация
│   │   └── mod/           # встроенные модули (JSON)
│   └── models/            # SQLAlchemy-модели
├── utils/                 # утилиты
│   ├── llm/               # клиенты LLM (DeepSeek)
│   ├── sqlite.py          # подключение к БД
│   └── static.py          # раздача статики
├── alembic/               # миграции
├── cli.py                 # CLI
└── app.py                 # фабрика FastAPI

Лицензия

MIT. См. LICENSE.

Ссылки

PyPI: https://pypi.org/project/neurocad/
GitHub: https://github.com/aleksmir-dev/neurocad

Metadata

Release files for neurocad 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for neurocad 1.0.0
File	Size	Uploaded
neurocad-1.0.0.tar.gz	8.8 MB	Oct 1, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for neurocad 1.0.0
File	Interpreter	ABI	Platform	Reset
neurocad-1.0.0-py3-none-any.whl 10.2 MB Oct 1, 2026	Python 3	none	any	Details

Total release size: 19.0 MB

Release files / neurocad-1.0.0.tar.gz

Download URL	neurocad-1.0.0.tar.gz
Size	8.8 MB
Tags	Source
SHA-256 checksum How to use checksums	`3d67686da110cb88e52864411479b50f4f791f7efb5a1507506e429d3cb98a11`
BLAKE2b-256 checksum How to use checksums	`4de90daa917b59cd1886abb65740392ac07ea84727904c9f2409d98359be06f3`
Upload date	Oct 1, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.3`

Release files / neurocad-1.0.0-py3-none-any.whl

Download URL	neurocad-1.0.0-py3-none-any.whl
Size	10.2 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`40832e2aea238ce36ee9f980c0a1c0713b79128dec7c23a3032d0941111d81a9`
BLAKE2b-256 checksum How to use checksums	`5af671289845a7a7516cd5b6ad8f9388af1b3aaadb7aa1f10d07dacaa3ed6466`
Upload date	Oct 1, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.3`