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