@graphmemory/server 1.1.0 → 1.3.0

package/LICENSE

@@ -1,15 +1,87 @@
-ISC License
+Copyright (c) 2025-2026 Graph Memory Team
 
-Copyright (c) 2026 prih
+Elastic License 2.0 (ELv2)
 
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted, provided that the above
-copyright notice and this permission notice appear in all copies.
+URL: https://www.elastic.co/licensing/elastic-license
 
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
-REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
-AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
-INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
-LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
-OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
-PERFORMANCE OF THIS SOFTWARE.
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject
+to the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set
+of the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other
+notices of the licensor in the software. Any use of the licensor's trademarks
+is subject to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If your company
+makes such a claim, your patent license ends immediately for work on behalf
+of your company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from
+you also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license
+no later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your
+licenses to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is
+the software the licensor makes available under these terms, including any
+portion of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that organization.
+**control** means ownership of substantially all the assets of an entity, or
+the power to direct the management and policies of an entity.

package/README.md

@@ -6,86 +6,90 @@ then exposes them as **58 MCP tools** + **REST API** + **Web UI**.
 
 ## Quick start
 
-### Docker (recommended)
-
 ```bash
-# 1. Create graph-memory.yaml
-cat > graph-memory.yaml << 'EOF'
-server:
-  host: "0.0.0.0"
-  port: 3000
-  modelsDir: "/data/models"
+npm install -g @graphmemory/server
+cd /path/to/my-project
+graphmemory serve
+```
 
-projects:
-  my-app:
-    projectDir: "/data/projects/my-app"
-EOF
+That's it. No config file needed — the current directory becomes your project. Open http://localhost:3000 for the web UI.
 
-# 2. Run
-docker run -d \
-  --name graph-memory \
-  -p 3000:3000 \
-  -v $(pwd)/graph-memory.yaml:/data/config/graph-memory.yaml:ro \
-  -v /path/to/my-app:/data/projects/my-app:ro \
-  -v graph-memory-models:/data/models \
-  ghcr.io/graph-memory/graphmemory-server
-```
+The embedding model (~560 MB) downloads on first startup and is cached at `~/.graph-memory/models/`.
 
-Open http://localhost:3000 — the web UI is ready. The embedding model (~560 MB) downloads on first startup.
+### Connect an MCP client
 
-### npm
+**Claude Code:**
 
 ```bash
-npm install -g @graphmemory/server
-graphmemory serve --config graph-memory.yaml
+claude mcp add --transport http --scope project graph-memory http://localhost:3000/mcp/my-project
 ```
 
-### From source
+**Claude Desktop** — add via **Settings > Connectors**, enter the URL:
 
-```bash
-git clone https://github.com/graph-memory/graphmemory.git
-cd graphmemory
-npm install && cd ui && npm install && cd ..
-npm run build
-node dist/cli/index.js serve --config graph-memory.yaml
+```
+http://localhost:3000/mcp/my-project
 ```
 
-## Connect an MCP client
+**Cursor / Windsurf / other clients** — enter the URL directly in settings:
+
+```
+http://localhost:3000/mcp/my-project
+```
+
+The project ID is your directory name. Multiple clients can connect simultaneously.
 
-Start the server, then connect MCP clients to `http://localhost:3000/mcp/{projectId}`.
+### With a config file
 
-**Claude Desktop** — add via **Settings > Connectors** in the app, enter the URL:
+For multi-project setups, custom embedding models, auth, or workspaces — create `graph-memory.yaml`:
 
+```yaml
+projects:
+  my-app:
+    projectDir: "/path/to/my-app"
+  docs-site:
+    projectDir: "/path/to/docs"
+    graphs:
+      code:
+        enabled: false
 ```
-http://localhost:3000/mcp/my-app
+
+```bash
+graphmemory serve --config graph-memory.yaml
 ```
 
-**Claude Code** — run in your project directory:
+See [docs/configuration.md](docs/configuration.md) for full reference and [graph-memory.yaml.example](graph-memory.yaml.example) for all options.
+
+### Docker
 
 ```bash
-claude mcp add --transport http --scope project graph-memory http://localhost:3000/mcp/my-app
+docker run -d \
+  --name graph-memory \
+  -p 3000:3000 \
+  -v $(pwd)/graph-memory.yaml:/data/config/graph-memory.yaml:ro \
+  -v /path/to/my-app:/data/projects/my-app:ro \
+  -v graph-memory-models:/data/models \
+  ghcr.io/graph-memory/graphmemory-server
 ```
 
-Or add to `.mcp.json` manually:
-
-```json
-{
-  "mcpServers": {
-    "graph-memory": {
-      "type": "http",
-      "url": "http://localhost:3000/mcp/my-app"
-    }
-  }
-}
-```
+Docker Compose:
 
-**Cursor / Windsurf / other clients** — enter the URL directly in settings:
+```yaml
+services:
+  graph-memory:
+    image: ghcr.io/graph-memory/graphmemory-server
+    ports:
+      - "3000:3000"
+    volumes:
+      - ./graph-memory.yaml:/data/config/graph-memory.yaml:ro
+      - /path/to/my-app:/data/projects/my-app
+      - models:/data/models
+    restart: unless-stopped
 
-```
-http://localhost:3000/mcp/my-app
+volumes:
+  models:
 ```
 
-See [docs/cli.md](docs/cli.md) for stdio transport and other connection options.
+See [docs/docker.md](docs/docker.md) for details.
 
 ## What it does
 
@@ -99,7 +103,7 @@ See [docs/cli.md](docs/cli.md) for stdio transport and other connection options.
 | **Skills** | Reusable recipes with steps, triggers, and usage tracking |
 | **Hybrid search** | BM25 keyword + vector cosine similarity with BFS graph expansion |
 | **Real-time** | File watching + WebSocket push to UI |
-| **Multi-project** | One process manages multiple projects with YAML hot-reload |
+| **Multi-project** | One process manages multiple projects from a single config |
 | **Workspaces** | Share knowledge/tasks/skills across related projects |
 | **Auth & ACL** | Password login (JWT), API keys, 4-level access control |
 
@@ -125,31 +129,6 @@ Graph (Cytoscape.js visualization), Tools (MCP explorer), Help.
 
 Light/dark theme. Real-time WebSocket updates. Login page when auth is configured.
 
-## Configuration
-
-All configuration via `graph-memory.yaml`. Only `projects.<id>.projectDir` is required:
-
-```yaml
-server:
-  host: "127.0.0.1"
-  port: 3000
-  embedding:
-    model: "Xenova/bge-m3"
-
-projects:
-  my-app:
-    projectDir: "/path/to/my-app"
-    graphs:
-      docs:
-        include: "**/*.md"               # default
-      code:
-        include: "**/*.{js,ts,jsx,tsx}"  # default
-      skills:
-        enabled: false
-```
-
-See [docs/configuration.md](docs/configuration.md) for full reference and [graph-memory.yaml.example](graph-memory.yaml.example) for all options.
-
 ## Authentication
 
 ```yaml
@@ -171,26 +150,6 @@ server:
 
 See [docs/authentication.md](docs/authentication.md).
 
-## Docker Compose
-
-```yaml
-services:
-  graph-memory:
-    image: ghcr.io/graph-memory/graphmemory-server
-    ports:
-      - "3000:3000"
-    volumes:
-      - ./graph-memory.yaml:/data/config/graph-memory.yaml:ro
-      - /path/to/my-app:/data/projects/my-app
-      - models:/data/models
-    restart: unless-stopped
-
-volumes:
-  models:
-```
-
-See [docs/docker.md](docs/docker.md).
-
 ## Development
 
 ```bash
@@ -211,6 +170,12 @@ Full documentation is in [docs/](docs/README.md):
 - **UI**: [architecture](docs/ui-architecture.md), [features](docs/ui-features.md), [patterns](docs/ui-patterns.md)
 - **Development**: [testing](docs/testing.md), [API patterns](docs/api-patterns.md)
 
+## Contributing
+
+Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+For security vulnerabilities, see [SECURITY.md](SECURITY.md).
+
 ## License
 
-ISC
+[Elastic License 2.0 (ELv2)](LICENSE) — free to use, modify, and self-host. Not permitted to offer as a managed/hosted service.