README.ro RO

Reduceți cu 80% cheltuielile pe token-uri ale agenților. Graphify Cloud este o memorie mereu activă care guvernează agenții, menține calitatea codului ridicată și dovedește corectitudinea prin verificare formală. Începeți o perioadă de probă gratuită de 14 zile →

Tastați /graphify în asistentul AI de programare, iar acesta vă mapează întregul proiect (cod, documentație, PDF-uri, imagini, videoclipuri) într-un graf de cunoștințe pe care îl puteți interoga în loc să faceți grep prin fișiere.

• Maparea codului gratuit, complet local. Codul este analizat cu tree-sitter AST: determinist, fără LLM, nimic nu părăsește mașina voastră. (Documentația, PDF-urile, imaginile și videoclipurile folosesc modelul asistentului vostru sau o cheie API configurată pentru o trecere semantică.)
• Fiecare muchie este explicată. Fiecare conexiune este etichetată EXTRACTED (explicită în sursă) sau INFERRED (rezolvată de graphify), astfel încât puteți distinge ce a fost citit direct de ce a fost dedus.
• Nu este un index vectorial. Fără embeddings, fără stocare vectorială: un graf real pe care îl parcurgeți. Puneți o întrebare, trasați calea dintre două lucruri sau explicați un concept.

[!NOTE] Vreți asta mereu activă? Graphify Cloud menține graful viu pe tot parcursul SDLC-ului vostru: suport pentru monorepo și între repo-uri, verificare formală și revizuire de cod cu o vedere de ansamblu asupra SDLC-ului vostru, plus conectori pentru Sentry, Jira și altele, astfel încât incidentele și tichetele să stea în același graf ca și codul vostru. Începeți o perioadă de probă gratuită de 14 zile pe app.graphify.com.

Baza de cod FastAPI mapată de graphify. Fiecare nod este un concept, culorile sunt comunitățile detectate, iar totul este clicabil în graph.html.

Începeți (30 de secunde). Necesită Python 3.10+ și uv (sau pipx):

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

Apoi, în asistentul vostru AI:

/graphify .

Asta e tot. Obțineți trei fișiere:

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

Graful persistat include graph.schema_version astfel încât integrările să poată detecta modificările de format incompatibile, plus graph.graphify_version care identifică versiunea Graphify care l-a produs.

O singură instalare, orice asistent, orice sistem de operare. Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot și încă 20+, pe macOS, Linux și Windows: alegeți-vă platforma.

Vedeți-l în acțiune¶

Odată ce graful este construit, îl interogați în loc să citiți fișiere. Rezultat real, graphify rulat pe baza de cod FastAPI prezentată mai sus:

$ 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

Fiecare muchie poartă o etichetă de încredere (EXTRACTED = explicită în sursă, INFERRED = derivată prin rezolvare), astfel încât puteți distinge ce a fost citit direct de ce a fost dedus. graphify query "<question>" returnează un subgraf delimitat pentru o întrebare în limbaj natural, iar graphify path A B trasează modul în care se conectează oricare două lucruri.

Ce face¶

Ce obțineți direct din cutie:

[!TIP] Rulați asta pe multe repo-uri sau pe un monorepo? Graphify Cloud o face continuu și reduce cu 80% cheltuielile pe token-uri ale agenților, cu legături între repo-uri, revizuire de cod la nivelul întregului SDLC, verificare formală și conectori Sentry/Jira. Începeți o perioadă de probă gratuită de 14 zile →

Benchmark-uri: 0.497 recall@10, 0 LLM credits¶

Fiecare sistem a rulat pe același harness cu același model și aceleași bugete, punctat de un evaluator validat orb față de un al doilea evaluator (90.6% acord, kappa Cohen 0.81). Tabelele complete per sistem, rezultatul de inteligență a codului și comenzile de reproducere: BENCHMARKS.md.

Documentație¶

Ghidurile complete și referința se află la docs.graphify.com:

• Ghid de pornire rapidă: construiți primul vostru graf
• Referința CLI: fiecare comandă și opțiune
• Puneți întrebări mai bune despre graf: tipare de interogare
• Configurare: variabile de mediu și reglaje
• Intrări acceptate: limbaje și tipuri de fișiere
• Fluxuri de lucru în echipă și revizuire PR
• Depanare și Cum funcționează

Cerințe prealabile¶

Instalare rapidă pe macOS (Homebrew):

brew install python@3.12 uv

Instalare rapidă pe Windows:

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] Pachet oficial: Pachetul PyPI este graphifyy (dublu-y). Alte pachete graphify* de pe PyPI nu sunt afiliate. Comanda CLI rămâne graphify.

Depozitul sursă oficial este Graphify-Labs/graphify.

Ghidul rapid în două comenzi se află în partea de sus a acestui README. Această secțiune acoperă metodele de instalare, instalările la nivel de proiect și fiecare platformă acceptată.

Metode de instalare (alegeți una):

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

Apoi rulați graphify install o dată. Detectează ce asistent rulați și înregistrează skill-ul, așa că nu există configurare per asistent. Deschideți asistentul AI și tastați /graphify .

Pentru a instala skill-ul asistentului în depozitul curent în loc de profilul vostru de utilizator, adăugați --project:

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

Instalările la nivel de proiect scriu în directorul curent, de exemplu .claude/skills/graphify/SKILL.md sau .agents/skills/graphify/SKILL.md (plus un sidecar references/ pe care skill-ul îl încarcă la cerere), și afișează un indiciu git add pentru fișierele care pot fi comise. Comenzile per platformă care acceptă instalări la nivel de proiect acceptă aceeași opțiune, de exemplu graphify claude install --project sau graphify codex install --project.

[!TIP] Întâmpinați command not found, o problemă pip-pe-Mac/Windows, citarea PowerShell, utilizarea uvx, ciudățenii PATH la git-hook sau modul strict? Vedeți Instalare și Depanare.

Faceți asistentul să folosească mereu graful¶

Rulați asta o dată în proiectul vostru după construirea unui graf:

Rulați graphify <platform> install o dată în proiectul vostru, de exemplu graphify claude install sau graphify codex install (sau graphify install --platform <name>).

Asta scrie un mic fișier de configurare care îi spune asistentului vostru să consulte graful de cunoștințe pentru întrebări despre baza de cod, preferând interogări delimitate precum graphify query "<question>" în locul citirii raportului complet sau al grep-ului prin fișiere brute.

• Platforme cu hook-uri (Claude Code, Gemini CLI): un hook se declanșează automat înaintea apelurilor de unelte de tip căutare (și, pe Claude Code, înainte de citirea fișierelor sursă unul câte unul prin uneltele Read/Glob) și împinge asistentul către calea grafului.
• Platforme cu fișiere de instrucțiuni (Codex, OpenCode, Cursor etc.): fișierele de instrucțiuni persistente (AGENTS.md, .cursor/rules/ etc.) oferă aceeași îndrumare „întâi interogarea”.

GRAPH_REPORT.md este în continuare disponibil pentru revizuirea amplă a arhitecturii.

Exact ce fișiere scrie fiecare platformă (CODEBUDDY.md + hook-uri PreToolUse pentru CodeBuddy, AGENTS.md pentru Codex, pluginul nativ .kilo pentru Kilo, regula alwaysApply pentru Cursor și așa mai departe) este acoperit în Configurare mereu activă.

Pentru a elimina graphify de pe toate platformele deodată: graphify uninstall (adăugați --purge pentru a șterge și graphify-out/). Sau folosiți comanda per platformă (de ex. graphify claude uninstall).

Skill-uri CLI sau instrucțiuni MCP?¶

Instrucțiunile instalate de graphify install și cele furnizate cu o conexiune Graphify MCP descriu moduri diferite de a interoga un graf:

Ambele încurajează interogări delimitate ale grafului înaintea căutărilor ample în sursă. Alegeți instrucțiunile care se potrivesc cu uneltele la care asistentul vostru are efectiv acces; niciunul dintre blocuri nu stabilește o regulă universală de precedență pentru fișierele de instrucțiuni ale asistentului vostru. Dacă folosiți ambele integrări, identificați ce graf interoghează fiecare și alegeți o cale principală de interogare în loc să copiați două blocuri de instrucțiuni necondiționate în AGENTS.md.

graphify install instalează integrarea locală a asistentului; nu stabilește o conexiune MCP. Un client MCP nu are nevoie să ruleze interogări CLI locale pentru a-și folosi serverul conectat. Un server găzduit local are totuși nevoie de propria instalare Graphify și de propriul graf, în timp ce o conexiune găzduită poate servi un graf care nu este prezent în directorul de lucru al clientului. Dacă uneltele așteptate lipsesc, verificați instalarea CLI relevantă sau conexiunea MCP în loc să tratați instrucțiunile celeilalte configurări ca interschimbabile.

Ce este în raport¶

GRAPH_REPORT.md rezumă nodurile-zeu, comunitățile și căile-cheie pentru revizuirea amplă a arhitecturii. Cum este construit graful și ce conține: Cum funcționează graphify.

Ce fișiere gestionează: ~40 de limbaje¶

graphify analizează ~40 de limbaje de programare local cu tree-sitter AST și mapează documentația, PDF-urile, imaginile și audio/video printr-o trecere semantică opțională. Lista completă: Intrări acceptate.

Comenzi uzuale¶

/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

Vedeți referința completă a comenzilor mai jos.

Ignorarea fișierelor¶

graphify respectă .gitignore și acceptă tipare --exclude și un .graphifyignore la nivel de proiect. Detalii: Configurare.

Configurarea proiectului¶

Creați un .graphifyrc în rădăcina de scanare pentru setări care aparțin proiectului, nu unei singure rulări. Câte un key=value pe linie; liniile care încep cu # sunt comentarii.

Extensii ambigue. Unele extensii înseamnă limbaje diferite în proiecte diferite: .inc este PHP pe pfSense, Pascal într-un arbore Delphi, SQL sau assembly în altă parte; .h este C sau C++; .m este Objective-C sau MATLAB. graphify trebuie să aleagă o singură valoare implicită globală, iar când alege greșit fișierul nu eșuează: se analizează ca limbajul greșit și produce o mână de noduri incidentale, așa că graful pare populat în timp ce simbolurile reale lipsesc. Declarați ce înseamnă extensia în repo-ul vostru:

# .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

Declarația curge prin clasificare, selecția extractorului, gramatică și rezolvare, importuri, graphify watch și cache-ul AST (un fișier re-analizat sub un limbaj diferit nu reutilizează niciodată intrarea veche), iar același .graphifyrc este citit de extract, update, hook-uri, serverul MCP și skill-ul /graphify. O greșeală de tastare este raportată o dată pe stderr, iar scanarea continuă cu valorile implicite. Cum interacționează declarațiile cu cache-ul, reconstruirile incrementale și rezolvarea importurilor: Configurare.

Configurarea echipei¶

Comiteți sau partajați graful pentru ca întreaga echipă să interogheze același context și revizuiți pull request-urile cu context de graf. Vedeți Partajați contextul cu echipa și Revizuiți pull request-urile.

Folosirea directă a grafului¶

Dincolo de asistentul vostru AI, interogați graph.json direct din CLI cu graphify query, graphify path și graphify explain. Un nume care se potrivește cu mai multe noduri este refuzat, cu candidații listați în loc de ghicit. Scripturile pot citi rezultatul din codul de ieșire: 0 un răspuns, 3 un nume ambiguu, 4 niciun nod care se potrivește. Vedeți Puneți întrebări mai bune despre graf și referința de interogare.

Variabile de mediu¶

Backend-urile, cheile API, comportamentul hook-urilor și reglajele sunt controlate de variabile de mediu. Tabel complet: Configurare.

Confidențialitate¶

• Fișiere de cod: procesate local prin tree-sitter. Nimic nu părăsește mașina voastră. Un corpus format doar din cod nu necesită cheie API: graphify extract rulează complet offline. Pe un repo mixt, adăugați --code-only pentru a indexa doar codul și a sări peste documentele/PDF-urile/imaginile care altfel ar avea nevoie de un LLM.
• Video / audio: transcrise local cu faster-whisper. Nimic nu părăsește mașina voastră.
• Documente, PDF-uri, imagini: trimise asistentului vostru AI pentru extracție semantică (prin skill-ul /graphify, folosind orice model rulează sesiunea voastră IDE). graphify extract în mod headless necesită GEMINI_API_KEY / GOOGLE_API_KEY (Gemini), MOONSHOT_API_KEY (Kimi), ANTHROPIC_API_KEY (Claude), OPENAI_API_KEY (OpenAI), DEEPSEEK_API_KEY (DeepSeek), o instanță Ollama în funcțiune (OLLAMA_BASE_URL), credențiale AWS prin lanțul standard de furnizori (Bedrock - nu e nevoie de cheie API, folosește IAM), sau binarul CLI claude (Claude Code - nu e nevoie de cheie API, folosește abonamentul vostru Claude). Opțiunea --dedup-llm folosește aceeași cheie.
• Rezidența datelor: graphify extract detectează automat ce furnizor să folosească pe baza cheii API setate (prioritate: Gemini → Kimi → Claude → OpenAI → DeepSeek → Azure → Bedrock → Ollama). Pentru cod cu cerințe de rezidență a datelor, folosiți --backend ollama (complet local) sau transmiteți o opțiune --backend explicită. Kimi (MOONSHOT_API_KEY) rutează către serverele Moonshot AI din China.
• Fără telemetrie, fără urmărirea utilizării, fără analitică.
• Jurnalizarea interogărilor: fiecare apel graphify query, graphify path, graphify explain și MCP query_graph este jurnalizat în ~/.cache/graphify-queries.log în format JSON Lines (marcaj de timp, întrebare, corpus, noduri returnate, durată). Răspunsurile complete de subgraf nu sunt stocate în mod implicit. Setați GRAPHIFY_QUERY_LOG_DISABLE=1 pentru a renunța, sau GRAPHIFY_QUERY_LOG=/dev/null pentru a reduce la tăcere fără a dezactiva calea de cod.

Depanare¶

Probleme uzuale de instalare și extracție și soluțiile lor: Depanare.

Referința completă a comenzilor¶

Fiecare comandă și opțiune, cu exemple: Referința CLI.

Aflați mai multe¶

• docs.graphify.com: documentație completă: ghiduri, referința comenzilor și integrări
• Cum funcționează: pipeline-ul de extracție, detecția comunităților, punctarea încrederii, benchmark-uri
• ARCHITECTURE.md: defalcarea modulelor, cum să adăugați un limbaj
• Integrări opționale: Docker MCP Toolkit + SQLite
• The Memory Layer: cartea despre ideile din spatele graphify, arhitectura de la cap la coadă

Graphify Cloud¶

Graphify Cloud este stratul mereu activ construit deasupra graphify. În loc de un graf pe care îl reconstruiți la cerere pentru fiecare folder, menține un singur graf viu pe tot parcursul ciclului vostru de dezvoltare software:

• Cu 80% mai puține token-uri: memoria mereu activă înseamnă că agenții voștri nu mai recitesc și reexplică baza de cod la fiecare sesiune.
• Monorepo și între repo-uri: un singur graf conectat peste fiecare serviciu și repozitoriu, nu un graf per folder.
• Verificare formală: verificați invarianții arhitecturali și de dependențe față de graful viu.
• Revizuire de cod cu o vedere de ansamblu asupra SDLC-ului: vedeți cum se propagă o modificare prin întregul sistem înainte de a face merge.
• Conectori SDLC: aduceți Sentry, Jira și altele, astfel încât incidentele, tichetele și codul să trăiască într-un singur graf.
• Mereu activ: se actualizează continuu în fundal peste cod, documente și întâlniri.

Începeți o perioadă de probă gratuită de 14 zile pe app.graphify.com →

Contribuții¶

Contribuțiile sunt binevenite. Vedeți CONTRIBUTING.md pentru configurarea de dezvoltare, comenzile de test și de paritate cu CI, fluxul de lucru git și ce înseamnă o contribuție puternică (exemplele lucrate și rapoartele de erori de extracție sunt cele mai utile). Arhitectura și cum să adăugați un limbaj: ARCHITECTURE.md.

Nou aici? Salutați pe Discord sau în GitHub Discussions.

Contribuitori¶

Realizat cu contrib.rocks.

Traduceri¶

README-ul este disponibil în 32 de limbi. Folosiți comutatorul de limbă din partea de sus a acestui fișier pentru a-l citi în a voastră, sau răsfoiți docs/translations/. Pentru a îmbunătăți o traducere sau a adăuga una nouă, deschideți un pull request față de fișierul corespunzător de acolo.

A construi pe graphify¶

Construiți ceva în ecosistemul graphify? Asta este încurajat. Dacă proiectul vostru folosește „graphify” în numele său (de exemplu graphify-dashboard sau graphify-action), vă rugăm să adăugați o scurtă notă în README-ul vostru care să clarifice că este construit de comunitate și nu este afiliat cu, ori aprobat de, Graphify Labs. „graphify” și logo-ul graphify sunt mărci ale Graphify Labs; vă rugăm să nu le folosiți într-un mod care sugerează un statut oficial.

Comunitate și linkuri¶