graphiti

AutoGineer overview, from the brain’s own files

Memory model: Hybrid. Folders: .github (agent config, 38 files); examples (examples, 34 files); images (attachments, 4 files); server (source code, 17 files); spec (tests, 7 files); tests (tests, 75 files). The agent reads graphiti_core. The agent writes server/, mcp_server/, add_memory.

The agent reads

• graphiti_core evidence: AGENTS.md

The agent writes

• server/ evidence: AGENTS.md
• mcp_server/ evidence: AGENTS.md
• add_memory evidence: CLAUDE.md

AutoGineer’s guidance for this type of brain

Install the library in your own agent code and call it to store and retrieve memories; see its documentation for the API.

Agent instructions that run or fetch something (25)

• .github/copilot-instructions.md: Code that `make format` or `make lint` already accepts.
• AGENTS.md: `make install`: install the dev environment (`uv sync --extra dev`).
• AGENTS.md: `make format`: run `ruff` to sort imports and apply the canonical formatter.
• AGENTS.md: `make lint`: execute `ruff` plus `pyright` type checks against `graphiti_core`.
• AGENTS.md: `make test`: run unit tests only, excluding integration tests and disabling non-Neo4j drivers (`DISABLE_FALKORDB=1 DISABLE_KUZU=1 DISABLE_NEPTUNE=1 uv run pytest -m "not integration"`).
• AGENTS.md: `make check`: run format, lint, and test in sequence.
• AGENTS.md: `uv run pytest tests/path/test_file.py`: target a specific module or test selection.
• AGENTS.md: Run `make format` before committing to normalize imports and docstring formatting.
• AGENTS.md: `make test` excludes these by default.
• AGENTS.md: Async tests run automatically via `asyncio_mode = auto` in `pytest.ini`.
• AGENTS.md: Reproduce regressions with a failing test first and validate fixes via `uv run pytest -k "pattern"`.
• AGENTS.md: Confirm `make lint` and `make test` pass locally, and update docs or examples when public interfaces shift.
• AGENTS.md: Dependencies are installed by the startup update script (`uv sync` in the repo root, `server/`, and `mcp_server/`).
• AGENTS.md: `sudo docker run -d --name falkordb --network host falkordb/falkordb:latest` (port 6379)
• AGENTS.md: `sudo docker run -d --name neo4j --network host -e NEO4J_AUTH=neo4j/testpass -e NEO4J_PLUGINS='["apoc"]' neo4j:5.26-community` (bolt 7687, http 7474)
• AGENTS.md: `make test` does NOT set `DISABLE_NEO4J`, so the `graph_driver` fixture stays parametrized on Neo4j and the suite REQUIRES a reachable Neo4j at `bolt://localhost:7687`.
• AGENTS.md: Run it as `NEO4J_PASSWORD=[redacted] make test`.
• AGENTS.md: All three run without a valid OpenAI key for startup/health only;
• AGENTS.md: REST API (`server/`): `OPENAI_API_KEY=<placeholder-or-real> DB_BACKEND=falkordb FALKORDB_HOST=localhost FALKORDB_PORT=6379 uv run uvicorn graph_service.main:app --reload --port 8000`.
• AGENTS.md: MCP server (`mcp_server/`): `OPENAI_API_KEY=<...> FALKORDB_URI=redis://localhost:6379 uv run python main.py --transport http --host 127.0.0.1 --port 8001 --database-provider falkordb`.
• CLAUDE.md: Run tests with `make test` or `pytest`
• CLAUDE.md: Run specific test files: `pytest tests/test_specific_file.py`
• CLAUDE.md: Run specific test methods: `pytest tests/test_file.py::test_method_name`
• CLAUDE.md: Run only integration tests: `pytest tests/ -k "_int"`
• CLAUDE.md: Run only unit tests: `pytest tests/ -k "not _int"`

Install scripts (1)

• Makefile (make install): $(UV) sync --extra dev