skills.rest
topoteretes
topoteretesOFFICIAL
Explore all skills by this author →
Website𝕏@cognee_GitHub

cognee-docker

Deploy the cognee API server and full stack using Docker images and compose profiles.

30.4k|3.0k|Updated Aug 16, 2023
Search Tags:#docker#docker compose#Deployment#neo4j#Postgres#API server#Cognee
One-click install
npx skills add https://github.com/topoteretes/cognee --skill cognee-docker
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cognee-docker
Source: https://github.com/topoteretes/cognee/tree/main/.claude/skills/cognee-docker
Command: npx skills add https://github.com/topoteretes/cognee --skill cognee-docker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Running cognee locally requires configuring databases, LLM providers, and multiple services; this Skill guides you through starting cognee with Docker, from a single prebuilt container to the full compose stack with UI, MCP, Postgres, and Neo4j.

Core Features & Use Cases

  • Prebuilt Image Quickstart: Run the cognee/cognee:main image with only an LLM_API_KEY, then verify with the /health endpoint and interactive docs at port 8000.
  • Memory API Usage: Ingest and query data through /api/v1/remember and /api/v1/recall, including search_type routing behavior and snake_case/camelCase field aliases.
  • Full Stack Profiles: Bring up optional compose profiles for the frontend (port 3000), MCP server (port 8001), Postgres/pgvector, and Neo4j.
  • Use Case: You want to try cognee without cloning the repo: save a minimal docker-compose.yml, export your OpenAI key, run docker compose up, and immediately remember and recall a note via curl.

Quick Start

Ask the AI to start cognee locally with the prebuilt Docker image and show the curl commands to remember a note and recall it.

Frequently Asked Questions about cognee-docker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run cognee with Docker?▼

Create a docker-compose.yml using the cognee/cognee:main image, export your LLM_API_KEY, and run docker compose up. The API server starts on port 8000 with interactive docs at /docs and a /health endpoint for verification.

How do I use the cognee remember and recall API endpoints?▼

POST a file as multipart form data to /api/v1/remember with a datasetName to ingest and build the graph in one call. Then POST JSON with a query and datasets list to /api/v1/recall to search the memory.

Can I run cognee with Postgres and Neo4j in Docker?▼

Yes, the repository docker-compose.yml includes opt-in profiles: use --profile postgres for pgvector/pg17 and --profile neo4j for the graph database. When the database runs on the host, set DB_HOST=host.docker.internal.

Why do cognee API calls fail with authentication errors in Docker?▼

ENABLE_BACKEND_ACCESS_CONTROL defaults to true, so every API call requires authentication. For a single-user local try-out, set ENABLE_BACKEND_ACCESS_CONTROL to "false" in the container environment.

How do I persist cognee data across Docker container restarts?▼

Set DATA_ROOT_DIRECTORY=/cognee-data/data and SYSTEM_ROOT_DIRECTORY=/cognee-data/system, then mount a named volume at /cognee-data. Without a volume, all data lives inside the container and is lost on removal.

Related Skills

Explore More Software Engineering Skills→
HouseGarofaloHouseGarofalo
3

localai

Deploy and manage self-hosted AI models with an OpenAI-compatible API.

Official
Intermediate
syeda-hoorain-alisyeda-hoorain-ali

llm-provider-configuration

Configure the OpenAI Agents SDK with a custom base URL and API key for alternative LLM providers.

Community
Intermediate
BrownbullBrownbull

Docker Orchestrator Skill

Orchestrate Docker containers for local development services via docker-compose.

Community
Intermediate
sayalinvidiasayalinvidia

cuopt-install

Guide cuOpt installation via pip, conda, or Docker with CUDA checks.

Community
Intermediate