Marfa: типизированный слой данных для хранения и доступа к записям
Marfa — это типизированный самостоятельный слой данных для структурированных персональных данных, который можно запустить у себя. Он позволяет хранить заметки, задачи и другие записи в одном месте с заданной пользователем структурой, и предоставляет доступ к этим данным для любых приложений и агентов, которым вы доверяете.
Проект подойдет тем, кто хочет иметь полный контроль над своими данными без привязки к конкретным приложениям. Marfa поддерживает интеграцию с существующими сервисами, такими как GitHub и Todoist через connectors, а также предлагает возможности работы с приложениями на TypeScript и Swift. Также он может работать офлайн: приложения на Swift сохраняют данные локально и синхронизируются при восстановлении соединения.
Запускается Marfa через HTTP API, и проект уже доступен на GitHub, но помни, что это ранняя версия (0.0.x) — все может измениться, и стабильности пока нет. Будь внимателен к этому при использовании на практике.
Что такое Marfa
Marfa — это проект, позволяющий хранить личные данные на собственном сервере. Здесь ты можешь организовать свои заметки, задачи, записи о прочитанном и другое в том виде, который тебе удобен. Ты контролируешь структуру своих данных и предоставляешь доступ к ним только тем приложениям, скриптам или AI-агентам, которым доверяешь. Это позволяет сосредоточиться на возможности взаимодействия и использования данных, а не на их хранении.
Как устроен Marfa
Marfa организован вокруг одного сервера, который хранит данные в базе данных SQLite и файловой системе. Каждая инстанция Marfa принадлежит одному пользователю и управляется через API. Клиенты, использующие Marfa, могут быть как нативными приложениями, так и веб-приложениями, и они взаимодействуют только с сервером, что обеспечивает безопасность данных и их консистентность.
- Клиенты: Есть нативные клиенты, которые работают на Swift, и CLI-инструмент, которые обеспечивают оффлайн-доступ к данным. Также существуют онлайн-клиенты, которые обращаются к API через TypeScript SDK.
- Подключение данных: Marfa поддерживает подключатели для интеграции с другими сервисами, такими как GitHub, Todoist и RSS.
- Работа оффлайн: При помощи Swift SDK клиенты могут хранить локальные копии данных и синхронизировать изменения, когда это будет возможно.
Как установить и запустить
Для запуска Marfa на собственном сервере или локально, следуй следующим шагам:
- Ты можешь развернуть Marfa на платформе Railway, используя [шаблон Railway](https://railway.com/new/template/5z9-Ja?utm_medium=integration&utm_source=button&utm_campaign=marfa), который создаст сервер с необходимыми настройками.
- Если ты хочешь запустить Marfa на своем компьютере, следуй инструкциям по установке для Mac или Linux.
- Для локального тестирования нужно установить CLI и сервер, выполнив следующую команду:
curl -fsSL https://raw.githubusercontent.com/withmarfa/marfa/main/scripts/install.sh | sh
После установки сервера запроси его доступ через команду:
marfa server install --access local
Что стоит учесть
На данный момент Marfa находится на начальной стадии разработки (версия 0.0.x), поэтому функционал может изменяться, и некоторые аспекты могут быть нестабильными. Также, обратите внимание, что для полноценной работы локальную версию Marfa лучше запускать на Mac с Apple Silicon или Linux на x86_64 или arm64. Храни данные и секреты в безопасности, так как они не сохраняются дополнительно.
Где найти документацию
Документация по проекту доступна на сайте docs.marfa.so, где ты сможешь найти информацию о быстром старте и других аспектах использования Marfa.
Радар проекта: 59 из 100 — рабочий, но с оговорками
- Импульс 12 ≈ 27 звёзд в месяц
- Темп разработки — GitHub ещё считает статистику
- Зрелость 80 проекту 8 месяцев, 81 релиз
- Сообщество 29 3 участника, 13 форков
- Свежесть 100 последний коммит — сегодня
- Быстрый старт 45 есть: команда установки, сайт/демо
- Готовность к продакшену 55 релиз v0.0.84, автосборка
- Безопасность и доверие 75 лицензия Apache-2.0, организация
- Документация 86 README 8.4 тыс. знаков, 6 разделов
- Экосистема 46 2 подписчика на обновления, 8 тем
Как считаем
Только открытые данные GitHub на 20.11.2026, без оценок нейросети. Каждая ось — от 0 до 100, итог — среднее.
- Импульс — звёзд в день: за время наших замеров, а пока их нет — за всю жизнь проекта; 200 в день — максимум.
- Темп разработки — коммитов за последние 12 недель; 300 — максимум. Пока GitHub не досчитал статистику, ось не учитывается.
- Зрелость — возраст проекта (3 года — максимум) и число релизов (30 — максимум), поровну.
- Сообщество — участников с коммитами (200 — максимум) и форков (5000 — максимум), поровну.
- Свежесть — дней с последнего коммита: сегодня — 100, полгода и больше или архив — 0.
- Быстрый старт — в README есть команда установки, раздел «быстрый старт» или примеры использования, в репозитории — Docker и папка примеров, у проекта есть сайт или демо.
- Готовность к продакшену — релизы, версия 1.0 и выше, автосборка (GitHub Actions), тесты, лицензия, журнал изменений.
- Безопасность и доверие — открытая лицензия (своя — половина балла), политика безопасности (SECURITY.md), проект организации, правила для участников, не в архиве.
- Документация — объём и структура README, папка docs или сайт, оценка «здоровья сообщества» GitHub.
- Экосистема — звёзды (50 тыс. — максимум), подписчики на обновления (1000 — максимум), темы репозитория.
Открыть на GitHub: withmarfa/marfa →
RepoRadar