README.hu HU

Csökkentse az ügynökök tokenköltségét 80%-kal. A Graphify Cloud mindig aktív memória, amely irányítja az ügynökeit, magasan tartja a kódminőséget, és formális verifikációval bizonyítja a helyességet. Indítson ingyenes 14 napos próbaidőszakot →

Írja be a /graphify parancsot az AI-kódolási asszisztensébe, és az a teljes projektjét (kód, dokumentumok, PDF-ek, képek, videók) tudásgráffá alakítja, amelyet lekérdezhet ahelyett, hogy grep-pel keresgélne a fájlok között.

• A kód feltérképezése ingyenes, teljesen lokális. A kódot a tree-sitter AST elemzi: determinisztikus, nincs LLM, semmi sem hagyja el a gépét. (A dokumentumok, PDF-ek, képek és videók az asszisztense modelljét vagy egy beállított API-kulcsot használnak egy szemantikai futtatáshoz.)
• Minden él magyarázattal rendelkezik. Minden kapcsolat EXTRACTED (a forrásban explicit) vagy INFERRED (a graphify által feloldott) címkét kap, így meg tudja különböztetni a közvetlenül kiolvasott dolgokat a kikövetkeztetettektől.
• Nem vektorindex. Nincsenek beágyazások, nincs vektortár: egy valódi gráf, amelyet bejár. Tegyen fel egy kérdést, kövesse nyomon a két dolog közötti utat, vagy magyaráztasson el egy fogalmat.

[!NOTE] Szeretné ezt mindig aktívan? A Graphify Cloud a teljes SDLC-jén át élőben tartja a gráfot: monorepo- és repository-közi támogatás, formális verifikáció, valamint kódellenőrzés madártávlatból az SDLC-jéről, továbbá konnektorok a Sentryhez, Jirához és másokhoz, hogy az incidensek és jegyek ugyanabban a gráfban legyenek, mint a kódja. Indítson ingyenes 14 napos próbaidőszakot az app.graphify.com oldalon.

A graphify által feltérképezett FastAPI-kódbázis. Minden csomópont egy fogalom, a színek az észlelt közösségek, és az egész kattintható a graph.html fájlban.

Kezdés (30 másodperc). Python 3.10+ és uv (vagy pipx) szükséges:

uv tool install graphifyy      # install the CLI (or: pipx install graphifyy)
graphify install               # detects your assistant and registers the skill

Majd az AI-asszisztensében:

/graphify .

Ennyi az egész. Három fájlt kap:

graphify-out/
├── graph.html       open in any browser: click nodes, filter, search
├── GRAPH_REPORT.md  the highlights: key concepts, surprising connections, suggested questions
└── graph.json       the full graph: query it anytime without re-reading your files

A megőrzött gráf tartalmazza a graph.schema_version mezőt, hogy az integrációk észlelhessék a nem kompatibilis formátumváltozásokat, valamint a graph.graphify_version mezőt, amely azonosítja az azt előállító Graphify-kiadást.

Egy telepítés, bármely asszisztens, bármely operációs rendszer. Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot és több mint 20 további, macOS, Linux és Windows rendszeren: válassza ki a platformját.

See it in action¶

Miután a gráf elkészült, azt lekérdezi ahelyett, hogy fájlokat olvasna. Valódi kimenet, a graphify a fent látható FastAPI-kódbázison futtatva:

$ graphify explain "APIRouter"
Node: APIRouter
  Source:    routing.py L2210
  Community: 2
  Degree:    47

Connections (47):
  --> RequestValidationError [uses] [INFERRED]
  --> Dependant [uses] [INFERRED]
  --> .get() [method] [EXTRACTED]
  <-- __init__.py [imports] [EXTRACTED]
  ...

$ graphify path "FastAPI" "ModelField"
Shortest path (3 hops):
  FastAPI --uses--> DefaultPlaceholder <--references-- get_request_handler() --references--> ModelField

Minden él megbízhatósági címkét hordoz (EXTRACTED = a forrásban explicit, INFERRED = feloldással származtatott), így meg tudja különböztetni a közvetlenül kiolvasott dolgokat a kikövetkeztetettektől. A graphify query "<question>" egy természetes nyelvű kérdéshez tartozó szűkített részgráfot ad vissza, a graphify path A B pedig nyomon követi, hogyan kapcsolódik össze bármely két dolog.

What it does¶

Amit alapból kap:

[!TIP] Sok repón vagy egy monorepón át futtatja ezt? A Graphify Cloud folyamatosan végzi, és 80%-kal csökkenti az ügynökök tokenköltségét, repository-közi hivatkozásokkal, SDLC-szintű kódellenőrzéssel, formális verifikációval és Sentry/Jira konnektorokkal. Indítson ingyenes 14 napos próbaidőszakot →

Benchmarks: 0.497 recall@10, 0 LLM credits¶

Minden rendszer ugyanazon a harness-en futott, ugyanazzal a modellel és költségkeretekkel, egy olyan bíró által pontozva, amelyet egy második bíróval szemben vakon validáltak (90.6% egyezés, Cohen-féle kappa 0.81). Teljes rendszerenkénti táblázatok, a kód-intelligencia eredmény és a reprodukciós parancsok: BENCHMARKS.md.

Documentation¶

A teljes útmutatók és a referencia itt található: docs.graphify.com:

• Quickstart: építse fel az első gráfját
• CLI reference: minden parancs és flag
• Ask better graph questions: lekérdezési minták
• Configuration: környezeti változók és finomhangolás
• Supported inputs: nyelvek és fájltípusok
• Team workflows és PR review
• Troubleshooting és How it works

Prerequisites¶

macOS gyors telepítés (Homebrew):

brew install python@3.12 uv

Windows gyors telepítés:

winget install astral-sh.uv

Ubuntu/Debian:

sudo apt install python3.12 python3-pip pipx
# or install uv:
curl -LsSf https://astral.sh/uv/install.sh | sh

Install¶

[!IMPORTANT] Hivatalos csomag: A PyPI-csomag a graphifyy (dupla y). A PyPI egyéb graphify* csomagjai nem kapcsolódnak hozzá. A CLI-parancs továbbra is graphify.

A hivatalos forrás-repository a Graphify-Labs/graphify.

A kétparancsos gyorsindító e README tetején található. Ez a szakasz a telepítési módszereket, a projekt-hatókörű telepítéseket és minden támogatott platformot ismertet.

Telepítési módszerek (válasszon egyet):

uv tool install graphifyy   # recommended, isolated env (if 'graphify' isn't found after, run: uv tool update-shell)
pipx install graphifyy      # alternative
pip install graphifyy       # may need PATH setup, see Troubleshooting below

Majd futtassa egyszer a graphify install parancsot. Felismeri, melyik asszisztenst használja, és regisztrálja a skillt, így nincs asszisztensenkénti beállítás. Nyissa meg az AI-asszisztensét, és írja be: /graphify .

Ha az asszisztens-skillt a felhasználói profilja helyett az aktuális repository-ba szeretné telepíteni, adja hozzá a --project kapcsolót:

graphify install --project
graphify install --project --platform codex

A projekt-hatókörű telepítések az aktuális könyvtárba írnak, például .claude/skills/graphify/SKILL.md vagy .agents/skills/graphify/SKILL.md (plusz egy references/ kiegészítő, amelyet a skill igény szerint tölt be), és git add tippet írnak ki a commitolható fájlokhoz. A projekt-hatókörű telepítéseket támogató platformspecifikus parancsok ugyanazt a kapcsolót fogadják el, például graphify claude install --project vagy graphify codex install --project.

[!TIP] command not found hibába, egy Mac/Windows-on jelentkező pip-problémába, PowerShell-idézőjelezésbe, uvx-használatba, git-hook PATH-furcsaságokba vagy strict módba ütközik? Lásd: Installation és Troubleshooting.

Make your assistant always use the graph¶

Futtassa ezt egyszer a projektjében, miután felépített egy gráfot:

Futtassa egyszer a graphify <platform> install parancsot a projektjében, például graphify claude install vagy graphify codex install (vagy graphify install --platform <name>).

Ez egy kis konfigurációs fájlt ír ki, amely arra utasítja az asszisztensét, hogy a kódbázissal kapcsolatos kérdésekhez a tudásgráfot konzultálja, a szűkített lekérdezéseket, mint a graphify query "<question>", előnyben részesítve a teljes jelentés olvasásával vagy a nyers fájlok grep-elésével szemben.

• Hook-platformok (Claude Code, Gemini CLI): egy hook automatikusan elindul a keresés jellegű eszközhívások előtt (és Claude Code esetén, mielőtt a forrásfájlokat egyenként beolvasná a Read/Glob eszközökkel), és az asszisztensét a gráf felé tereli.
• Utasításfájl-platformok (Codex, OpenCode, Cursor stb.): a perzisztens utasításfájlok (AGENTS.md, .cursor/rules/ stb.) ugyanazt a lekérdezés-első útmutatást nyújtják.

A GRAPH_REPORT.md továbbra is elérhető a széles körű architektúra-áttekintéshez.

Hogy pontosan mely fájlokat írja ki az egyes platformok (a CodeBuddy CODEBUDDY.md + PreToolUse hookjai, a Codex AGENTS.md-je, a Kilo natív .kilo beépülője, a Cursor alwaysApply szabálya és így tovább), azt a Always-on setup ismerteti.

A graphify egyszerre minden platformról való eltávolításához: graphify uninstall (adja hozzá a --purge kapcsolót a graphify-out/ törléséhez is). Vagy használja a platformspecifikus parancsot (pl. graphify claude uninstall).

CLI skills or MCP instructions?¶

A graphify install által telepített utasítások és a Graphify MCP-kapcsolattal biztosított utasítások a gráf lekérdezésének különböző módjait írják le:

Mindkettő a szűkített gráflekérdezéseket ösztönzi a széles körű forráskeresések előtt. Válassza azokat az utasításokat, amelyek megfelelnek az asszisztense által ténylegesen elérhető eszközöknek; egyik blokk sem állapít meg univerzális elsőbbségi szabályt az asszisztense utasításfájljaira. Ha mindkét integrációt használja, állapítsa meg, melyik melyik gráfot kérdezi le, és válasszon egy elsődleges lekérdezési útvonalat ahelyett, hogy két feltétel nélküli utasításblokkot másolna az AGENTS.md fájlba.

A graphify install a helyi asszisztens-integrációt telepíti; nem hoz létre MCP-kapcsolatot. Egy MCP-kliensnek nem kell helyi CLI-lekérdezéseket futtatnia ahhoz, hogy a csatlakoztatott kiszolgálóját használja. Egy helyben üzemeltetett kiszolgálónak továbbra is szüksége van saját Graphify-telepítésre és gráfra, míg egy üzemeltetett kapcsolat olyan gráfot is kiszolgálhat, amely nincs jelen a kliens munkakönyvtárában. Ha a várt eszközök hiányoznak, ellenőrizze a megfelelő CLI-telepítést vagy MCP-kapcsolatot, ahelyett hogy a másik beállítás utasításait felcserélhetőnek tekintené.

What's in the report¶

A GRAPH_REPORT.md összefoglalja a god node-okat, közösségeket és kulcsfontosságú utakat a széles körű architektúra-áttekintéshez. Hogyan épül fel a gráf, és mit tartalmaz: How graphify works.

What files it handles: ~40 languages¶

A graphify ~40 programozási nyelvet elemez lokálisan a tree-sitter AST segítségével, és a dokumentumokat, PDF-eket, képeket és hang-/videóanyagokat egy opcionális szemantikai futtatáson át képezi le. Teljes lista: Supported inputs.

Common commands¶

/graphify .                        # build graph for current folder
/graphify ./docs --update          # re-extract only changed files
/graphify . --cluster-only         # rerun clustering without re-extracting
/graphify . --cluster-only --resolution 1.5      # more granular communities
/graphify . --cluster-only --exclude-hubs 99     # suppress utility super-hubs from god-node rankings
/graphify . --no-viz               # skip the HTML, just the report + JSON
/graphify . --wiki                 # build a markdown wiki from the graph
graphify export callflow-html      # Mermaid architecture/call-flow HTML (auto-regenerates on every git commit if hook is installed)

/graphify query "what connects auth to the database?"
/graphify path "UserService" "DatabasePool"
/graphify explain "RateLimiter"

/graphify add https://arxiv.org/abs/1706.03762   # fetch a paper and add it
/graphify add <youtube-url>                       # transcribe and add a video

graphify hook install              # auto-rebuild on commit + branch checkout (run `graphify update .` after `git pull`: see "Recommended workflow" below)
graphify merge-graphs a.json b.json              # combine two graphs

graphify prs                       # PR dashboard: CI state, review status, worktree mapping
graphify prs 42                    # deep dive on PR #42 with graph impact
graphify prs --triage              # AI ranks your review queue (uses whatever backend is configured)
graphify prs --conflicts           # PRs sharing graph communities: merge-order risk

Lásd lentebb a teljes parancsreferenciát.

Ignoring files¶

A graphify tiszteletben tartja a .gitignore fájlt, és támogatja a --exclude mintákat, valamint egy projekt .graphifyignore fájlt. Részletek: Configuration.

Project configuration¶

Hozzon létre egy .graphifyrc fájlt a szkennelési gyökérben azokhoz a beállításokhoz, amelyek a projekthez tartoznak, nem pedig egyetlen futtatáshoz. Soronként egy key=value; a # karakterrel kezdődő sorok megjegyzések.

Nem egyértelmű kiterjesztések. Egyes kiterjesztések különböző projektekben különböző nyelveket jelentenek: a .inc a pfSense-en PHP, egy Delphi-fában Pascal, máshol SQL vagy assembly; a .h C vagy C++; a .m Objective-C vagy MATLAB. A graphify-nak egyetlen globális alapértelmezést kell választania, és amikor rosszul választ, a fájl nem bukik el: rossz nyelvként elemzi, és egy maréknyi véletlenszerű csomópontot eredményez, így a gráf népesnek tűnik, miközben a valódi szimbólumok hiányoznak. Deklarálja, hogy a kiterjesztés mit jelent a repójában:

# .graphifyrc
# A language name:
language.inc=php
# Or an extension graphify already knows:
language.tpl=.ts
# Baked into the git hooks (see Team setup):
viz_node_limit=0

A deklaráció végigfut az osztályozáson, a kinyerő kiválasztásán, a nyelvtanon és feloldáson, az importokon, a graphify watch-on és az AST-gyorsítótáron (egy más nyelven újraelemzett fájl soha nem használja fel újra a régi bejegyzést), és ugyanazt a .graphifyrc fájlt olvassa az extract, az update, a hookok, az MCP-kiszolgáló és a /graphify skill. Az elgépelést egyszer jelenti a stderr-en, és a szkennelés az alapértelmezésekkel folytatódik. Hogyan hatnak egymásra a deklarációk a gyorsítótárazással, az inkrementális újraépítésekkel és az import-feloldással: Configuration.

Team setup¶

Commitolja vagy ossza meg a gráfot, hogy az egész csapata ugyanazt a kontextust kérdezze le, és ellenőrizze a pull requesteket gráfkontextussal. Lásd: Share context with your team és Review pull requests.

Using the graph directly¶

Az AI-asszisztensén túl a graph.json fájlt közvetlenül a CLI-ből is lekérdezheti a graphify query, graphify path és graphify explain parancsokkal. A több csomópontra illeszkedő nevet elutasítja, és a jelölteket felsorolja ahelyett, hogy találgatna. A szkriptek a kilépési kódból olvashatják ki az eredményt: 0 egy válasz, 3 egy nem egyértelmű név, 4 nincs illeszkedő csomópont. Lásd: Ask better graph questions és a query reference.

Environment variables¶

A backendeket, API-kulcsokat, hook-viselkedést és finomhangolást környezeti változók vezérlik. Teljes táblázat: Configuration.

Privacy¶

• Kódfájlok: lokálisan feldolgozva a tree-sitter segítségével. Semmi sem hagyja el a gépét. Egy csak kódot tartalmazó korpuszhoz nincs szükség API-kulcsra: a graphify extract teljesen offline fut. Vegyes repo esetén adja hozzá a --code-only kapcsolót, hogy csak a kódot indexelje, és kihagyja a dokumentumokat/PDF-eket/képeket, amelyekhez egyébként LLM kellene.
• Videó / hang: lokálisan átírva a faster-whisper segítségével. Semmi sem hagyja el a gépét.
• Dokumentumok, PDF-ek, képek: szemantikai kinyerésre elküldve az AI-asszisztensének (a /graphify skillen keresztül, azzal a modellel, amelyet az IDE-munkamenete futtat). A fej nélküli graphify extract a következők egyikét igényli: GEMINI_API_KEY / GOOGLE_API_KEY (Gemini), MOONSHOT_API_KEY (Kimi), ANTHROPIC_API_KEY (Claude), OPENAI_API_KEY (OpenAI), DEEPSEEK_API_KEY (DeepSeek), egy futó Ollama-példány (OLLAMA_BASE_URL), AWS-hitelesítő adatok a standard provider-láncon keresztül (Bedrock - nincs szükség API-kulcsra, IAM-et használ), vagy a claude CLI-bináris (Claude Code - nincs szükség API-kulcsra, az Ön Claude-előfizetését használja). A --dedup-llm kapcsoló ugyanazt a kulcsot használja.
• Adatrezidencia: a graphify extract automatikusan felismeri, melyik providert használja, annak alapján, hogy melyik API-kulcs van beállítva (prioritás: Gemini → Kimi → Claude → OpenAI → DeepSeek → Azure → Bedrock → Ollama). Adatrezidencia-követelményekkel rendelkező kód esetén használja a --backend ollama (teljesen lokális) beállítást, vagy adjon meg egy explicit --backend kapcsolót. A Kimi (MOONSHOT_API_KEY) a kínai Moonshot AI-kiszolgálókra irányít.
• Nincs telemetria, nincs használatkövetés, nincs analitika.
• Lekérdezés-naplózás: minden graphify query, graphify path, graphify explain és MCP query_graph hívás a ~/.cache/graphify-queries.log fájlba naplózódik JSON Lines formátumban (időbélyeg, kérdés, korpusz, visszaadott csomópontok, időtartam). A teljes részgráf-válaszok alapértelmezés szerint nem tárolódnak. Állítsa be a GRAPHIFY_QUERY_LOG_DISABLE=1 értéket a kikapcsoláshoz, vagy a GRAPHIFY_QUERY_LOG=/dev/null értéket a kódút letiltása nélküli elnémításhoz.

Troubleshooting¶

Gyakori telepítési és kinyerési problémák és azok megoldásai: Troubleshooting.

Full command reference¶

Minden parancs és flag, példákkal: CLI reference.

Learn more¶

• docs.graphify.com: teljes dokumentáció: útmutatók, parancsreferencia és integrációk
• How it works: a kinyerési folyamat, közösségészlelés, megbízhatósági pontozás, benchmarkok
• ARCHITECTURE.md: modulbontás, hogyan adjunk hozzá egy nyelvet
• Optional integrations: Docker MCP Toolkit + SQLite
• The Memory Layer: a könyv a graphify mögötti ötletekről, az architektúráról elejétől a végéig

Graphify Cloud¶

A Graphify Cloud a graphify tetejére épülő, mindig aktív réteg. Ahelyett, hogy mappánként igény szerint újraépítene egy gráfot, egyetlen élő gráfot tart fenn a teljes szoftverfejlesztési életciklusán át:

• 80%-kal kevesebb token: a mindig aktív memória azt jelenti, hogy az ügynökei minden munkamenetben abbahagyják a kódbázis újraolvasását és újramagyarázását.
• Monorepo és repository-közi: egyetlen összekapcsolt gráf minden szolgáltatáson és repository-n át, nem mappánkénti gráf.
• Formális verifikáció: architekturális és függőségi invariánsok ellenőrzése az élő gráf ellenében.
• Kódellenőrzés az SDLC madártávlati nézetével: lássa, hogyan gyűrűzik végig egy változás az egész rendszeren, mielőtt mergelne.
• SDLC-konnektorok: húzza be a Sentryt, Jirát és másokat, hogy az incidensek, jegyek és a kód egyetlen gráfban éljenek.
• Mindig aktív: folyamatosan frissül a háttérben a kódon, dokumentumokon és megbeszéléseken át.

Indítson ingyenes 14 napos próbaidőszakot az app.graphify.com oldalon →

Contributing¶

A hozzájárulásokat szívesen fogadjuk. A fejlesztési beállításért, a teszt- és CI-paritási parancsokért, a git-munkafolyamatért és azért, hogy mi tesz egy hozzájárulást erőssé (a kidolgozott példák és a kinyerési hibajelentések a leghasznosabbak), lásd: CONTRIBUTING.md. Architektúra és hogyan adjunk hozzá egy nyelvet: ARCHITECTURE.md.

Új itt? Köszönjön be a Discordon vagy a GitHub Discussions felületen.

Contributors¶

Készült a contrib.rocks segítségével.

Translations¶

A README 32 nyelven érhető el. Használja a fájl tetején lévő nyelvváltót, hogy a sajátján olvassa, vagy böngésszen a docs/translations/ között. Egy fordítás javításához vagy új hozzáadásához nyisson egy pull requestet az ottani megfelelő fájl ellen.

Building on graphify¶

Épít valamit a graphify ökoszisztémában? Ezt bátorítjuk. Ha a projektje a nevében a „graphify” szót használja (például graphify-dashboard vagy graphify-action), kérjük, adjon egy rövid megjegyzést a README-jéhez, amely tisztázza, hogy közösségi fejlesztésű, és nem áll kapcsolatban a Graphify Labs-szel, és nem is támogatja azt. A „graphify” és a graphify logó a Graphify Labs védjegyei; kérjük, ne használja őket olyan módon, amely hivatalos státuszt sugall.

Community and links¶