Skip to content

systemshift/memex

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Memex

AI-native knowledge graph + decentralized social network. Single binary, no runtime dependencies.

Install

curl -fsSL https://raw.githubusercontent.com/systemshift/memex/main/install.sh | sh

Or with Bun:

bun install && bun run start

What happens

  • Downloads knowledge graph server + IPFS automatically
  • Creates your cryptographic identity (Ed25519 DID)
  • Guides you through your first interaction

What is this

  • Knowledge graph (memex-server): entities, relationships, raw sources — stored locally in SQLite
  • Social network (dagit): IPFS-based, Ed25519-signed, no central servers
  • LLM (OpenAI): searches your graph, creates nodes, posts to dagit — all through natural language chat

Prerequisites

  • OPENAI_API_KEY environment variable set
export OPENAI_API_KEY=sk-...

Architecture

┌─────────────────────────────────────┐
│              memex TUI              │
│           (Ink terminal)            │
├─────────────┬───────────────────────┤
│  OpenAI API │    function calls     │
├─────────────┼───────────┬───────────┤
│ memex-server│   dagit   │   IPFS    │
│  (SQLite)   │  (Ed25519)│  (kubo)   │
└─────────────┴───────────┴───────────┘

Configuration

Variable Default Description
OPENAI_API_KEY (required) OpenAI API key
OPENAI_MODEL gpt-5.2 LLM model to use
PORT 8080 memex-server port
MEMEX_BACKEND sqlite Storage backend (sqlite or neo4j)
SQLITE_PATH ~/.memex/memex.db Database path
MEMEX_SERVER (auto-detect) Path to memex-server binary

CLI Flags

memex [options]

  --server-only     Start server without TUI
  --port PORT       Server port (default: 8080)
  --backend TYPE    sqlite or neo4j (default: sqlite)
  --db-path PATH    SQLite database path
  --skip-ipfs       Skip IPFS daemon setup
  --skip-download   Don't auto-download binaries
  -h, --help        Show help

Build from source

Requires Bun.

bun install
bun run build          # compile for current platform
bun run build:linux-x64    # cross-compile

License

BSD 3-Clause. See LICENSE.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published