Repolode
Submit
mattogodoy

mattogodoy/nametag

Self-hostable personal relationship manager for tracking people, birthdays, connections, and interactions, with an interactive network graph.

Open-source alternative to:MonicaClayGoogle Contacts

View on GitHub
Stars
1,114
Forks
63
Open issues
42
Last commit
10 days ago

What is it?

Nametag is a personal relationship manager for remembering the people in your life and how they are connected. You can store contact details, birthdays and other important dates, custom fields and photos, then link people to each other with custom relationship types.

The app visualizes your network as an interactive force-directed graph and a map of geocoded addresses. A journal lets you log interactions over time, and reminders help you stay in touch. Contacts can be synced over CardDAV with Google Contacts, iCloud, Outlook, and Nextcloud, and imported or exported as vCard or JSON.

Nametag is deployed with Docker and offers a REST API with OpenAPI docs, token authentication, and OIDC/SSO login. It is available in many languages and as an installable PWA. The project is licensed under AGPL-3.0 and is also offered as a hosted service.

Key features

  • 01Track people with birthdays, important dates, photos, and custom fields
  • 02Map relationships between people using custom relationship types
  • 03Explore your network in an interactive force-directed graph
  • 04Sync contacts over CardDAV and import or export vCard and JSON
  • 05Log interactions in a journal and set reminders to stay in touch
  • 06Provides a REST API with OpenAPI docs and OIDC/SSO login

Use cases

  • Keeping track of friends, family, and colleagues and their birthdays
  • Remembering how people in your circle know each other
  • Self-hosting a private contact and relationship database
  • Logging conversations and follow-ups with people over time

Quick start

  1. 1

    Create and enter a project directory

    mkdir nametag && cd nametag
  2. 2

    Add a docker-compose.yml and .env file from the installation guide

  3. 3

    Start the containers

    docker compose up -d
  4. 4

    Open http://localhost:3000 in your browser

Things to know

  • Licensed under AGPL-3.0, a copyleft license that requires source disclosure if you modify and deploy it.
  • Under active development, so breaking changes may occur between releases; read the release notes before updating.
  • Self-hosting requires manually writing a docker-compose.yml and .env file following the external guide.

In collections

Self-hosted apps

Topics

#personal-crm#contacts#self-hosted#docker#carddav#graph-visualization#typescript

FAQ

What is nametag?
Self-hostable personal relationship manager for tracking people, birthdays, connections, and interactions, with an interactive network graph. Nametag is a personal relationship manager for remembering the people in your life and how they are connected. You can store contact details, birthdays and other important dates, custom fields and photos, then link people to each other with custom relationship types.
Is nametag free to use? What license does it have?
nametag is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is nametag still maintained?
Actively maintained. The last commit to nametag was on Oct 28, 2026.
What can I use nametag for?
Keeping track of friends, family, and colleagues and their birthdays Remembering how people in your circle know each other Self-hosting a private contact and relationship database Logging conversations and follow-ups with people over time
How do I install nametag?
Create and enter a project directory: mkdir nametag && cd nametag Add a docker-compose.yml and .env file from the installation guide Start the containers: docker compose up -d Open http://localhost:3000 in your browser
Where can I get nametag?
The source code and installation instructions are on GitHub: https://github.com/mattogodoy/nametag

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects