Marianne
A desktop citizen assistant for people living in France: rights, formalities, papers and deadlines, public information. It works with your own command-line Claude Code, Codex or Mistral Vibe, through its own tools only, and keeps everything in one encrypted archive on your computer.
Status: alpha. To install and use it, see the user guide, in English or in French, and the releases. Marianne is an independent project, not affiliated with the French State or any administration.
- User guide: installing and using Marianne, in French and in English, the same pages in each.
- Design: the window, folders, the archive and its security, engines, tools, planned tasks.
- Services: the 3615 add-ons and their SDK.
- Content: skills, guided démarches, the calendar, sites, and the news sources of 3615 INFOS with their editorial lines; how to contribute, and how signed updates reach the app.
- Site: the website, to download the app and read the user guide and the manifesto (why we make Marianne).
Development
Node 24 and npm. The repository is an npm workspace: the app in apps/desktop, its packages in packages/ (the SDK, the archive, the profile, the content) and the services in services/. The root holds only the workspace and its tools; its scripts run the app's.
npm install # installs and links the workspace packages
npm run dev # the app; the window reloads live, the main process restarts on change
npm run check # Prettier, no stray .gitkeep, package boundaries, type checks and tests (app and packages)
npm run build # apps/desktop/out/
npm run dist # installers, in apps/desktop/dist/
npm run content:bundle # the content bundle, in packages/content/dist/ (signed: docs/content.md)
The website is in site/, an Astro project of its own, outside the workspace: cd site && npm install && npm run dev (see site/README.md).
Marianne keeps this computer's data in ~/.marianne (MARIANNE_HOME moves it); accounts are .marianne archives in the folder you choose.
Contributing
Contributions are welcome, in English: bugs, ideas, content corrections, services and code. See CONTRIBUTING.md, and the code of conduct. Security issues are reported privately: see SECURITY.md.
License
MIT
