Быстрый старт · Документация · Статус проекта · Участие в разработке
Lumen — открытое рабочее пространство для проектов, задач и знаний. Заметки и задачи живут в обычных Markdown-файлах. Веб-интерфейс связывает их с календарём, документами и внешними сервисами, а один Go-бинарник запускает всё приложение на вашем компьютере или сервере.
Скриншоты сняты на демонстрационном хранилище. Интерфейс использует дизайн-систему
Интерфейс на библиотеке Velessoft UI 0.2: компоненты и токены --vs-*, Manrope и JetBrains Mono локально.
- Задачи на каждый день. Сегодня, неделя, входящие, просроченное; быстрый ввод
Подготовить макет !A @завтра, сроки, приоритеты и подробные описания. - Проекты и знания вместе. Проектные документы, вложенные материалы, Markdown,
[[wikilinks]], теги, обратные ссылки и поиск. - Редактирование с защитой черновика. Внешние правки и конфликты версий показываются в редакторе; несохранённый текст остаётся доступен.
- Календарь и интеграции. ICS, CalDAV, Nextcloud Notes, GitHub и Gitea. Импортированные материалы сохраняют локальные дополнения вне блока источника.
- Своё хранилище. Обычная папка файлов, совместимый Markdown, опциональное шифрование содержимого. Заметки можно редактировать вне Lumen.
- Самостоятельное размещение. Встроенный веб-клиент, контейнер, Bearer-токен или OIDC/Keycloak. Чтение паролей из Bitwarden/Vaultwarden/KeePass через CLI.
Для сборки нужны Go 1.26, Node.js 24+, npm, Git и Make. На Windows используйте PowerShell-инструкцию.
git clone https://github.com/villetacore/lumen.git
cd lumen
npm ci --prefix web
make app
./dist/lumend --vault ./my-vault --openОткроется http://127.0.0.1:8787. Отсутствующая папка my-vault создастся
автоматически. После сборки Node.js не нужен: веб-клиент встроен в lumend.
Для разработки с hot reload запустите make dev: интерфейс будет доступен
на http://localhost:5173, данные — в отдельной .dev-vault.
docker run -d --name lumen \
-p 127.0.0.1:8787:8787 \
-v lumen-vault:/vault \
ghcr.io/villetacore/lumen:mainЭтот пример доступен только локально. Для сервера настройте HTTPS и авторизацию; для воспроизводимой установки закрепите тег коммита. Обновление, резервное копирование и откат описаны в инструкции эксплуатации.
| Я хочу… | Куда перейти |
|---|---|
| Запустить Lumen и создать первые записи | Начало работы |
| Разобраться с задачами, проектами и документами | Руководство пользователя |
| Подключить календарь или трекер | Интеграции |
| Разместить на своём сервере | Сборка и доставка · Эксплуатация |
| Изменить код | Разработка · Архитектура |
| Работать через API или с файлами | HTTP API · Формат Markdown |
| Найти остальные инструкции | Каталог документации |
Lumen активно развивается. Текущая рабочая область — Go-сервер и React-клиент.
Один экземпляр lumend обслуживает один vault; все допущенные пользователи имеют
доступ ко всему хранилищу. Индекс и внешние календарные события находятся в памяти;
после перезапуска календарь загружается из источников повторно.
Следующее направление — AI-центр управления студией:
поручения, агенты, проверяемые результаты и общие права доступа. Агентный runtime,
RAG, MCP и проектные ACL пока не реализованы. Порядок работ — в
плане реализации, фактические результаты — в
журнале. Исторический Flutter/Rust-клиент остаётся в
desktop/ и не входит в текущий цикл проверки backend/web.
Баги и предложения принимаются в Issues. Для pull request начните с CONTRIBUTING.md: там описаны локальные проверки, границы изменений и требования к сохранности данных. Об уязвимостях — SECURITY.md.
Код распространяется по MIT. Manrope и JetBrains Mono — по SIL Open Font License. Создано в velessoft.

