How do I install the Server Guide skill?

Run npx skillmds@latest add tomevault-io/server-guide in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Server Guide skill do?

Overview of the FastAPI server and REST API Use when this capability is needed. It is listed under Integrations & APIs on SkillMD.

Is Server Guide safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Server Guide?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Server Guide free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Server Guide?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Server Guide by tomevault-io — Agent Skill

Name: Server Guide
Author: tomevault-io

File contents

Server Layer Guide

Overview of the server layer in narrativegraphs/server/.

Components

Component	Purpose
app.py	FastAPI application with routes and static file serving
backgroundserver.py	Run server in notebooks or background
requests.py	Pydantic request models
routes/	API endpoint handlers by entity type
static/	Frontend visualization assets

Running the Server

Standalone: Set DB_PATH env var, run with uvicorn

In notebooks:

from narrativegraphs.server import BackgroundServer
server = BackgroundServer(db_engine, port=8001)
server.start()

Route Organization

Router	Prefix	Service
graph	`/graph`	GraphService
entities	`/entities`	EntityService
documents	`/docs`	DocService
relations	`/relations`	RelationService
cooccurrences	`/cooccurrences`	CooccurrenceService

All routes use QueryService via dependency injection.

Architecture

FastAPI App
    ├── Lifespan: DB engine + QueryService init
    ├── Routes (routes/) → QueryService sub-services
    └── Static Files → Frontend visualization

BackgroundServer → Wraps app for notebook usage

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: server-guidedescription: Overview of the FastAPI server and REST API Use when this capability is needed.---# Server Layer GuideOverview of the server layer in `narrativegraphs/server/`.## Components| Component | Purpose || ----------------------- | ------------------------------------------------------- || **app.py** | FastAPI application with routes and static file serving || **backgroundserver.py** | Run server in notebooks or background || **requests.py** | Pydantic request models || **routes/** | API endpoint handlers by entity type || **static/** | Frontend visualization assets |## Running the Server**Standalone:** Set `DB_PATH` env var, run with uvicorn**In notebooks:**```pythonfrom narrativegraphs.server import BackgroundServerserver = BackgroundServer(db_engine, port=8001)server.start()```## Route Organization| Router | Prefix | Service || ------------- | ---------------- | ------------------- || graph | `/graph` | GraphService || entities | `/entities` | EntityService || documents | `/docs` | DocService || relations | `/relations` | RelationService || cooccurrences | `/cooccurrences` | CooccurrenceService |All routes use `QueryService` via dependency injection.## Architecture```FastAPI App ├── Lifespan: DB engine + QueryService init ├── Routes (routes/) → QueryService sub-services └── Static Files → Frontend visualizationBackgroundServer → Wraps app for notebook usage```---> Converted and distributed by [TomeVault](https://tomevault.io/claim/kasperfyhn) — claim your Tome and manage your conversions.

Frequently asked questions

Server Guide