Categories
All Softwares
Sublime Text VSCode Binaries Postman TeamViewer Firebase Visual Studio Code Contentful Tribe Circle Notion Datadog NewRelic Vmix Archbee Docker Desktop Bitly GitHub BitBucket Upsource Zapier Make Medium substack Facebook Amazon S3 Maya 3DS MAX Adobe Substance Airtable Roam Research Azure DevOps Retool Powerapps Appsheet 1Password Plex Emby Netflix Apple HomeKit Algolia Lightshot Confluence Toad tableau Data Studio Salesforce SAP Calendly Google photos Bloomberg Terminal BigQuery ML Google AutoML Tables Shopify BigCommerce Google Drive Redis Memcached Windows media player WhatsApp Heroku Render Looker Quizlet Google Analytics Auth0 Trello Elasticsearch Adobe Premiere Pro Zerotier Zoom Skype Docker Polypane Google Chrome Microsoft Edge Safari Gitbook Gmail Google Vertex AI Kdb+ Amplitude Google Docs Typora Roboflow ML Kit Azure Intercom Quicken YNAB Uptime Robot Figma npm TigerGraph Amazon Neptune Fivetran Okta YouTube LastPass Mailchimp Sendinblue Adobe Acrobat Pocket Reddit Onenote Shogun DaVinci Resolve UiPath Taliscale Adobe Lightroom FullStory LogRocket RescueTime Boxcryptor LaunchDarkly ArcGIS AWS SageMaker Tailscale NordVPN WooCommerce Twitter Dropbox Nagios Zabbix Prtg Google Cloud Webflow ActiveCampaign Quickbooks .Net Maui Airplane.dev Pipedream Evernote Autodesk AutoCAD HCL Connections Google Sheets Excel Rundeck Ansible Tower Salt Twilio Pastebin Zoho Unity3D GameMaker AWS Config GCP Cloud Asset inventory AWS GuardDuty Unreal Engine (UE4) Jira YouTrack Stytch Suite CRM Greynoise Photoshop LinkTree BlackBoard Zendesk Discord Rollout.io Disqus Oracle Fusion ERP Cloud Odoo Microsoft Dynamics Alfred Sophos Firewall UniFi Security Gateway Azure AD Doodle Office Online Power BI MicroStrategy Qlik Ampache Socrata Drone CI IOS WordPress IDM FDM Ninja Download Manager McAfee Google Meet WIX cPanel LucidChart HubSpot Landbot Typeform CCleaner Ecwid Spotify Stackstrom N8N Substance Painter Onshape SketchUp Canny Miro XMind Segment GoogleForms Adobe Illustrator MultiSim Proteus Prezi Slack Microsoft Teams SumSub JAWS Wetransfer Framer Microsoft 365 Telegram Threema Signal Lokalise Crowdin Phrase WolframAlpha Dataclay Templater Bot WorkOS FrontEgg Snorkel AI ZohoCRM Voicemod Chromatic Percy POEditor Transifex Microsoft Office Selenium vBulletin Xenforo Hightouch Logseq Bundlephobia Webpack Esbuild Rollup Session Berty WHMCS Stripe Billing Google Camera ImgIX Netlify Google Keep SocialPilot Hootsuite Firebase Analytics Access Manager Wordle Amazon Redshift Snowflake Microsoft Active Directory ClubHouse Tenable Nessus Obsidian Scrivener IDA Neo4j Pushbullet Pushover TinkerCAD Fusion360 SolidWorks TablePlus Cryptomator Glasswire Comodo Firewall Coyim Splunk Hungry Bring Panther IFTTT openHAB Alexa Google Home Twitch Asana IBM Watson Discovery FL Studio Ableton Google Maps Gather Aseprite Instagram Agora Wowza Docuware ELO Office Apollo GraphQL Supabase Hasura Stepzen Postgraphile Lyket.dev Kahoot Clubdesk Fairgate Bandicam Revoltchat Element Imply Pinot MongoDB Oracle Peoplesoft CurseForge Google Tag Manager MS SQL AppWrite Nhost AWS Kendra QnA Maker Apigee Google Cloud IoT Core Microsoft OneNote Amazon API Gateway Qualtrics Sprig Hotjar Sibelius Finale Dorico Snyk Common Room Orbit Toggl Track Adobe Scan Microsoft Lens CamScanner Vercel Stack Overflow Traktor Pro 3 Markup CMS Documentation Atlassian Confluence Raindrop Akeneo Salsify Informatica SuiteCRM VtigerCRM Cruise Tesla autopilot Waymo Adobe Animate Pencil2D Men&Mice Solarwinds Infoblox Device42 AWS WAF
Unigraph

Unigraph

Open Source Alternative to Roam Research, Logseq
Language
TypeScript
Stars
751
Watchers
751
Forks
54
Open Issues
24
Last Updated
5/4/2025

REAMDE.md

Unigraph

A local-first and universal knowledge graph, personal search engine, and workspace for your life.

Please join the Discord community below to talk about contributing, or open a GitHub issue if you want to help!

Discord

Docs

License: MIT

Getting started

Running with Docker image

We provide an experimental Dockerfile for easy setup:

  • Building Unigraph: docker build -t unigraph-devserver . (this should take roughly 10 minutes max),
  • Running Unigraph: docker run -d -p 4002:4002 -v <data directory>:/opt/unigraph -p 4001:4001 -p 3000:3000 -P unigraph-devserver,
  • Open http://localhost:3000 in a Browser that supports JavaScript to access Unigraph. If container is running on a different machine, replace localhost accordingly.

To update the Docker image, run docker build again after git pull.

Building from source

1) Build the Dgraph backend binary from source [reference]

requires gcc, make, go>=1.13

git clone https://github.com/unigraph-dev/dgraph.git
cd ./dgraph
make install  # installs built binary in $GOPATH/bin
# you can view your $GOPATH by running:  go env GOPATH
# and similarly, confirm binary exists:
> ls $(go env GOPATH)/bin | grep dgraph
dgraph

Alternative for step 1): find Unigraph's Dgraph binary for your platform on GitHub Releases and rename it to dgraph. On Linux or macOS, you'll need to make it executable: chmod +x ./Downloads/dgraph. Then, continue to step 2).

2) In the unigraph project root, fetch and build project dependencies:

if you have node.js versioning issues, consider using nvm. Windows users, see the note further down.

yarn && yarn build-deps

3) Move the Dgraph binary you built in step 1) to a new /opt/unigraph directory. This is a project default, but you can use a path of your choosing (as well as keep a separate data directory & bin path).

check that your user can read/write to the path(s) — you may need to e.g. chown -R $(whoami) /opt/unigraph

4) Run the backend and frontend from the unigraph project root!

the Dgraph backend currently requires its default ports to be free, especially 8080.

# run backend with default data and bin path:  /opt/unigraph
./scripts/start_server.sh
# or, run backend with custom paths:
./scripts/start_server.sh -d "<data directory>" -b "<dgraph binary location>"
# run frontend application in a browser:
yarn explorer-start
# or, to run as an electron application:
yarn electron-start

NOTE: if the backend failed during server initialization, you'll need a clean application state before reattempting:

  • killall dgraph to kill all running dgraph processes, then
  • remove p/, w/, zw/ in your data directory (by default /opt/unigraph)

Server initialization is successful upon unigraph> Unigraph server listening on port 4002 and announcing upserts.

5) If you want to use third-party API integrations, consult the "API Keys" section below.


Alternative Setup for Windows Dev/Technically Savvy Users

If you have managed to get a Dgraph instance running in WSL or via Docker, but would like to hack on Unigraph under Windows, the following commands can get the frontend and local backend built and connecting to Dgraph. These commands depend on PowerShell. Note that Windows comes with an older version of PowerShell, but you should install the most recent version from here. The binary, pwsh.exe, should be on your path after installation.

In one PowerShell terminal instance execute the following commands:

yarn
yarn build-deps
yarn backend-start

In another PowerShell terminal instance run this command, when the last command of the previous set has finished upserting to Dgraph:

yarn explorer-start

If you want to change Unigraph's default Ctrl + e shortcut for the Omnibar (which in Windows can pop up the browser's search bar), you can do it by editing the following section of packages\unigraph-dev-explorer\src\pages\SearchOverlay.tsx (currently hardcoded):

document.onkeydown = function(evt) {
    evt = evt || window.event;
    if ((evt.ctrlKey || evt.metaKey) && evt.key === 'e' && !isElectron()) {
        if (open === undefined) setSearchEnabled(!searchEnabled);
    }
    if ((searchEnabled) && evt.key === 'Escape') {
        setSearchEnabled(false);
    }
};

Updating Unigraph

Unigraph is being worked on constantly. If you're interested in getting the latest version, do the following:

  • git pull to retrieve the latest changes;
  • make sure backend and dgraph is not running;
  • yarn build-deps to re-build common libraries and default packages;
  • ./script/start_server.sh to re-start backend, and update any new packages if available.

Structure

This repository contains all relevant source code for Unigraph:

  • packages/
    • unigraph-dev-backend/ : Unigraph local backend in Node.js.
    • unigraph-dev-common/ : shared data and utilities between backend and frontend.
    • unigraph-dev-explorer/ : Unigraph frontend in React.
    • default-packages/ : schema, data and code declarations for packages providing default functionalities. If you are looking to build packages, you can study example projects here.

API Keys

To use third-party API integrations, obtain desired API keys and put them in this format in a file named secrets.env.json before starting the server:

{
    "twitter": {
        "api_key": "abc",
        "api_secret_key": "abc",
        "bearer_token": "abc"
    },
    "reddit": {
        "client_id": "abc"
    },
    "openai": {
        "api_key": "abc"
    },
    "google": {
        "client_id": "abc",
        "client_secret": "abc"
    }
}

For how to obtain them, see the docs page.