# Naruvi

> Naruvi is an open-source, self-hosted, AI-native job search workspace. Save roles, check your fit against facts you've verified, draft a tailored CV and cover letter, and keep every reply and interview in one place.

Canonical page: https://naruvi.app/
Creator: El Jakani Yassine (https://github.com/Eljakani)
Source repository: https://github.com/Eljakani/naruvi-app
Software license: Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0)

## What is Naruvi?

Naruvi is an open-source, self-hosted career workspace. It keeps your job postings, fit checks, CVs, cover letters, emails, interviews and offers in one place, with an AI companion (an otter called Naruvi) that helps you take the next step.

This website describes the product. It does not host a user's authenticated workspace. The REST API and MCP server advertised on the homepage are features of a self-hosted installation, not public action endpoints on this website. The site's only runtime endpoint is the managed-version waitlist form; it is not a product API.

## Ways to run Naruvi

- **Self-hosted (available now):** free and open source. Run it on your own computer, a home server, or a VPS with the installer described below.
- **Managed (planned):** the same workspace, hosted for you, with nothing to install. It is not available yet and has no release date. Waitlist: https://naruvi.app/#managed

## Who is it for?

Naruvi is for people who want to organize their own job search and run their workspace on a computer or server they control. A managed version for people who would rather not run a server is planned. It supports full-time and part-time roles, internships, and alternance contracts.

## How it works

One application, from saved to sent:

### Save the role

One click from the browser extension, a pasted posting or link, or a job-alert email.

- Requirements pulled out of the posting
- Perks and instructions kept apart
- Nothing is saved until you check it

### Check your fit

Every requirement compared with facts you’ve verified, before you spend an evening on it.

- Proven, partly shown or missing, per requirement
- Gaps named before a recruiter finds them

### Draft the CV and letter

Written for this job from your own facts. Refine them by asking, export when they read like you.

- Nothing invented, every claim checked
- Earlier wording one click away

### Follow through

Replies land on the right application. Interviews land in your calendar. The dashboard shows what needs you.

- IMAP, Google or Microsoft mail matched for you
- Private calendar feed and .ics downloads
- ntfy reminders when something is due

Setup and everything around it:

### Connect your AI

Bring the model you already trust. Naruvi uses it to read postings, check your fit and draft documents.

- Native Anthropic support
- Any OpenAI-compatible API
- A local model with Ollama

### Verify your facts once

Import your CV and confirm what’s true. Every fit check and every draft starts from these facts.

- Import an existing CV
- You confirm each fact before it’s used
- Document checks flag claims you can’t back up

### Capture from anywhere

Save a page with the browser extension, paste a posting, or let job-alert emails become leads.

- Browser extension for any job page
- Job-alert emails turn into leads
- Company research with sources: official site, Wikidata, Wikipedia

### Run the whole search

Every application on one board, your contacts beside it, and Naruvi’s own work in plain view.

- Drag applications from saved to offer
- Import contacts from CSV, Excel or LinkedIn
- Every AI run’s status and token usage in Runs

Workflow on the website: https://naruvi.app/#how

## Models and integrations

Anthropic natively, any OpenAI-compatible API, and local models through Ollama. You bring your own key, and you can switch at any time in Settings.

Integrations described on the homepage: Anthropic, OpenAI-compatible, Ollama, IMAP / SMTP, Gmail OAuth, Microsoft OAuth, iCalendar feed, ntfy, Whisper, REST API, MCP server, Browser extension, PostgreSQL, pgvector, Docker, .ics downloads, CSV / Excel import, LinkedIn connections import, Wikidata, Wikipedia, OpenAI-compatible providers such as OpenAI, Google Gemini, DeepSeek, Mistral, OpenRouter, Groq, xAI, Together AI, LM Studio and vLLM.

## Installation

You need Docker with Compose v2, Git and OpenSSL. A guided installer sets Naruvi up locally, on your own domain with automatic HTTPS, or behind Coolify, Traefik or nginx.

The homepage provides this installer sequence, including a step to read the downloaded script before executing it:

```bash
curl -fsSL https://raw.githubusercontent.com/Eljakani/naruvi-app/main/install.sh | bash
```

Installation section: https://naruvi.app/#start
Project installation guide, when accessible: https://github.com/Eljakani/naruvi-app/blob/main/docs/INSTALLATION.md

## Pricing and license

Yes. Naruvi is licensed under Apache 2.0. You run it on your own computer or server. If you use a hosted model provider, you pay that provider directly; with a local model like Ollama there’s no model bill at all.

The software being free does not include free hosting or free hosted model usage. Infrastructure and provider costs depend on the user's setup.

A managed (hosted) version is planned but not yet available; there is no release date. Not yet. A managed version is planned: the same workspace, hosted for you, with nothing to install. You can join the waitlist: confirm your address by email, then get one email when it opens. Self-hosting stays free and open source. Waitlist: https://naruvi.app/#managed

## Privacy and evidence

In your own PostgreSQL database and asset storage. Saved model credentials are encrypted at rest with AES-256-GCM. Your model provider only receives the context a workflow needs.

No. Drafts are built only from facts you’ve verified in your profile, and document checks flag claims you can’t back up. Evidence before eloquence.

Mailbox matching and ntfy reminders are optional connections. A configured external model provider receives the context needed for a workflow; using a local model through Ollama keeps those model requests local.

Privacy section: https://naruvi.app/#trust

## Creator and project

Naruvi was created by El Jakani Yassine. The creator describes its origin:

> Every application meant tailoring my CV again. Then a reply or interview would arrive, and I’d struggle to find the original job offer and retrace what I’d sent. Naruvi grew out of that: one place to keep the context and prepare without getting lost.

Creator section: https://naruvi.app/#creator
Creator profile: https://github.com/Eljakani
LinkedIn: https://www.linkedin.com/in/eljakaniyassine/
Contribution guide, when accessible: https://github.com/Eljakani/naruvi-app/blob/main/CONTRIBUTING.md

## Frequently asked questions

### What is Naruvi?

Naruvi is an open-source, self-hosted career workspace. It keeps your job postings, fit checks, CVs, cover letters, emails, interviews and offers in one place, with an AI companion (an otter called Naruvi) that helps you take the next step.

### Is Naruvi free?

Yes. Naruvi is licensed under Apache 2.0. You run it on your own computer or server. If you use a hosted model provider, you pay that provider directly; with a local model like Ollama there’s no model bill at all.

### Which AI models does it work with?

Anthropic natively, any OpenAI-compatible API, and local models through Ollama. You bring your own key, and you can switch at any time in Settings.

### Will it invent experience I don’t have?

No. Drafts are built only from facts you’ve verified in your profile, and document checks flag claims you can’t back up. Evidence before eloquence.

### Where does my data live?

In your own PostgreSQL database and asset storage. Saved model credentials are encrypted at rest with AES-256-GCM. Your model provider only receives the context a workflow needs.

### How do I install it?

You need Docker with Compose v2, Git and OpenSSL. A guided installer sets Naruvi up locally, on your own domain with automatic HTTPS, or behind Coolify, Traefik or nginx.

### Does it support internships and apprenticeships?

Yes. Naruvi handles all kinds of roles, including full-time, part-time, internships and alternance contracts.

### Is there a hosted version?

Not yet. A managed version is planned: the same workspace, hosted for you, with nothing to install. You can join the waitlist in the Install section: confirm your address by email, then get one email when it opens. Self-hosting stays free and open source.

FAQ section: https://naruvi.app/#faq

## About the examples

The companies, fit scores, salary quotes, email snippets, and application scenarios in the homepage demos are illustrative examples, not customer endorsements, verified outcomes, or live user data. Pip, Pebble, and Willow are illustrated otter friends standing in for future contributors, not real contributor profiles.

## Source and scope

This reference is generated from the public website's product descriptions, workflow, installation snippet, and FAQ data at build time. It is not a fetched copy of the repository documentation, and it does not establish a release version, uptime guarantee, or outcome guarantee. Repository links may require access if the project is not public.
