README.fi FI

Vähennä agenttien tokenkulutusta 80%. Graphify Cloud on aina päällä oleva muisti, joka ohjaa agenttejasi, pitää koodin laadun korkeana ja todistaa oikeellisuuden formaalilla verifioinnilla. Aloita ilmainen 14 päivän kokeilu →

Kirjoita /graphify AI-koodausavustajaasi, niin se kartoittaa koko projektisi (koodi, dokumentit, PDF-tiedostot, kuvat, videot) tietograafiksi, jota voit kysellä sen sijaan, että greppaisit tiedostoja läpi.

• Koodi kartoittuu ilmaiseksi, täysin paikallisesti. Koodi jäsennetään tree-sitter AST:llä: deterministisesti, ei LLM:ää, mikään ei poistu koneeltasi. (Dokumentit, PDF-tiedostot, kuvat ja video käyttävät avustajasi mallia tai määritettyä API-avainta semanttiseen käsittelyyn.)
• Jokainen kaari selitetään. Jokainen yhteys merkitään EXTRACTED (selkeä lähteessä) tai INFERRED (graphifyn päättelemä), joten voit erottaa suoraan luetun päätellystä.
• Ei vektori-indeksi. Ei embeddingejä, ei vektorivarastoa: oikea graafi, jota läpikäyt. Esitä kysymys, jäljitä polku kahden asian välillä tai selitä yksi käsite.

[!NOTE] Haluatko tämän aina päälle? Graphify Cloud pitää graafin elävänä koko SDLC:n läpi: monorepo- ja repojen välinen tuki, formaali verifiointi ja koodikatselmointi lintuperspektiivistä koko SDLC:ääsi, sekä liittimet Sentryyn, Jiraan ja muihin, niin että häiriöt ja tiketit ovat samassa graafissa kuin koodisi. Aloita ilmainen 14 päivän kokeilu osoitteessa app.graphify.com.

FastAPI-koodikanta graphifyn kartoittamana. Jokainen solmu on käsite, värit ovat havaittuja yhteisöjä, ja koko juttu on klikattavissa tiedostossa graph.html.

Pääse alkuun (30 sekuntia). Tarvitsee Python 3.10+ ja uv:n (tai pipx:n):

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

Sitten AI-avustajassasi:

/graphify .

Siinä kaikki. Saat kolme tiedostoa:

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

Tallennettu graafi sisältää graph.schema_version-tiedon, jotta integraatiot voivat havaita yhteensopimattomat formaattimuutokset, sekä graph.graphify_version-tiedon, joka yksilöi sen Graphify-julkaisun, joka sen tuotti.

Yksi asennus, mikä tahansa avustaja, mikä tahansa käyttöjärjestelmä. Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot ja 20+ muuta, macOS:llä, Linuxilla ja Windowsilla: valitse alustasi.

Katso se toiminnassa¶

Kun graafi on rakennettu, kyselet sitä sen sijaan, että lukisit tiedostoja. Oikeaa tulostetta, graphify ajettuna yllä näytetyllä FastAPI-koodikannalla:

$ 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

Jokainen kaari kantaa luottamusmerkintää (EXTRACTED = selkeä lähteessä, INFERRED = johdettu resoluutiolla), joten voit erottaa suoraan luetun päätellystä. graphify query "<question>" palauttaa rajatun aligraafin selkokieliseen kysymykseen, ja graphify path A B jäljittää, miten kaksi asiaa liittyvät toisiinsa.

Mitä se tekee¶

Mitä saat suoraan laatikosta:

[!TIP] Ajatko tätä useiden repojen tai monorepon yli? Graphify Cloud tekee sen jatkuvasti ja leikkaa agenttien tokenkulutusta 80%, repojen välisillä linkeillä, koko SDLC:n kattavalla koodikatselmoinnilla, formaalilla verifioinnilla ja Sentry/Jira-liittimillä. Aloita ilmainen 14 päivän kokeilu →

Benchmarks: 0.497 recall@10, 0 LLM credits¶

Jokainen järjestelmä ajettiin samassa testialustassa samalla mallilla ja budjeteilla, ja sen arvioi tuomari, joka oli sokkovalidoitu toista tuomaria vasten (90.6% yksimielisyys, Cohenin kappa 0.81). Täydelliset järjestelmäkohtaiset taulukot, koodiälykkyyden tulos ja toistokomennot: BENCHMARKS.md.

Dokumentaatio¶

Täydelliset oppaat ja viite löytyvät osoitteesta docs.graphify.com:

• Pikaopas: rakenna ensimmäinen graafisi
• CLI-viite: jokainen komento ja lippu
• Esitä parempia graafikysymyksiä: kyselymallit
• Konfiguraatio: ympäristömuuttujat ja viritys
• Tuetut syötteet: kielet ja tiedostotyypit
• Tiimin työnkulut ja PR-katselmointi
• Vianetsintä ja Miten se toimii

Edellytykset¶

macOS pika-asennus (Homebrew):

brew install python@3.12 uv

Windows pika-asennus:

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] Virallinen paketti: PyPI-paketti on graphifyy (kaksois-y). Muut graphify*-paketit PyPI:ssä eivät ole sidoksissa. CLI-komento on edelleen graphify.

Virallinen lähdekoodirepositorio on Graphify-Labs/graphify.

Kahden komennon pikaopas on tämän READMEn yläreunassa. Tämä osio kattaa asennusmenetelmät, projektikohtaiset asennukset ja jokaisen tuetun alustan.

Asennusmenetelmät (valitse yksi):

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

Aja sitten graphify install kerran. Se tunnistaa, mitä avustajaa ajat, ja rekisteröi taidon, joten avustajakohtaista asetusta ei tarvita. Avaa AI-avustajasi ja kirjoita /graphify .

Asentaaksesi avustajataidon nykyiseen repositorioon käyttäjäprofiilisi sijaan, lisää --project:

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

Projektikohtaiset asennukset kirjoittuvat nykyisen hakemiston alle, esimerkiksi .claude/skills/graphify/SKILL.md tai .agents/skills/graphify/SKILL.md (sekä references/-sivutiedosto, jonka taito lataa tarvittaessa), ja tulostavat git add -vihjeen tiedostoille, jotka voidaan committaa. Alustakohtaiset komennot, jotka tukevat projektikohtaisia asennuksia, hyväksyvät saman lipun, esimerkiksi graphify claude install --project tai graphify codex install --project.

[!TIP] Törmäätkö command not found-virheeseen, pip-ongelmaan Macilla/Windowsilla, PowerShell-lainausmerkkeihin, uvx-käyttöön, git-hookien PATH-erikoisuuksiin tai strict-tilaan? Katso Asennus ja Vianetsintä.

Saa avustajasi käyttämään aina graafia¶

Aja tämä kerran projektissasi graafin rakentamisen jälkeen:

Aja graphify <platform> install kerran projektissasi, esimerkiksi graphify claude install tai graphify codex install (tai graphify install --platform <name>).

Tämä kirjoittaa pienen konfiguraatiotiedoston, joka kehottaa avustajaasi konsultoimaan tietograafia koodikantakysymyksissä ja suosimaan rajattuja kyselyitä kuten graphify query "<question>" koko raportin lukemisen tai raakatiedostojen greppaamisen sijaan.

• Hook-alustat (Claude Code, Gemini CLI): hook laukeaa automaattisesti ennen hakutyylisiä työkalukutsuja (ja, Claude Codessa, ennen kuin lähdetiedostoja luetaan yksi kerrallaan Read/Glob-työkaluilla) ja ohjaa avustajaasi graafipolulle.
• Ohjetiedostoalustat (Codex, OpenCode, Cursor jne.): pysyvät ohjetiedostot (AGENTS.md, .cursor/rules/ jne.) tarjoavat saman kysely-ensin-ohjauksen.

GRAPH_REPORT.md on edelleen käytettävissä laajaan arkkitehtuurikatselmointiin.

Tarkalleen mitkä tiedostot kukin alusta kirjoittaa (CodeBuddyn CODEBUDDY.md + PreToolUse-hookit, Codexin AGENTS.md, Kilon natiivi .kilo-liitännäinen, Cursorin alwaysApply-sääntö ja niin edelleen) on käsitelty kohdassa Aina päällä -asetus.

Poistaaksesi graphifyn kaikilta alustoilta kerralla: graphify uninstall (lisää --purge poistaaksesi myös graphify-out/). Tai käytä alustakohtaista komentoa (esim. graphify claude uninstall).

CLI-taidot vai MCP-ohjeet?¶

graphify install -komennon asentamat ohjeet ja ne, jotka tulevat Graphify MCP -yhteyden mukana, kuvaavat eri tapoja kysellä graafia:

Molemmat kannustavat rajattuihin graafikyselyihin ennen laajoja lähdehakuja. Valitse ohjeet, jotka vastaavat työkaluja, joihin avustajasi todella pääsee käsiksi; kumpikaan lohko ei luo universaalia etusijasääntöä avustajasi ohjetiedostoille. Jos käytät molempia integraatioita, tunnista, mitä graafia kumpikin kyselee, ja valitse ensisijainen kyselypolku sen sijaan, että kopioisit kaksi ehdotonta ohjelohkoa tiedostoon AGENTS.md.

graphify install asentaa paikallisen avustajaintegraation; se ei luo MCP-yhteyttä. MCP-asiakkaan ei tarvitse ajaa paikallisia CLI-kyselyitä käyttääkseen yhdistettyä palvelintaan. Paikallisesti isännöity palvelin tarvitsee edelleen oman Graphify-asennuksensa ja graafinsa, kun taas isännöity yhteys voi tarjota graafin, jota ei ole asiakkaan työhakemistossa. Jos odotetut työkalut puuttuvat, tarkista asianmukainen CLI-asennus tai MCP-yhteys sen sijaan, että kohtelisit toisen asetuksen ohjeita keskenään vaihdettavina.

Mitä raportissa on¶

GRAPH_REPORT.md tiivistää jumalsolmut, yhteisöt ja keskeiset polut laajaan arkkitehtuurikatselmointiin. Miten graafi rakennetaan ja mitä se sisältää: Miten graphify toimii.

Mitä tiedostoja se käsittelee: ~40 kieltä¶

graphify jäsentää ~40 ohjelmointikieltä paikallisesti tree-sitter AST:llä, ja kartoittaa dokumentit, PDF-tiedostot, kuvat sekä äänen/videon valinnaisen semanttisen käsittelyn kautta. Täysi lista: Tuetut syötteet.

Yleiset komennot¶

/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

Katso täydellinen komentoviite alta.

Tiedostojen ohittaminen¶

graphify kunnioittaa .gitignore-tiedostoa ja tukee --exclude-malleja sekä projektikohtaista .graphifyignore-tiedostoa. Lisätietoja: Konfiguraatio.

Projektikonfiguraatio¶

Luo .graphifyrc skannausjuureen asetuksille, jotka kuuluvat projektille eivätkä yksittäiselle ajolle. Yksi key=value per rivi; #-merkillä alkavat rivit ovat kommentteja.

Monitulkintaiset tiedostopäätteet. Jotkin päätteet tarkoittavat eri kieliä eri projekteissa: .inc on PHP pfSensessä, Pascal Delphi-puussa, SQL tai assembly muualla; .h on C tai C++; .m on Objective-C tai MATLAB. graphifyn on valittava yksi globaali oletus, ja kun se valitsee väärin, tiedosto ei epäonnistu: se jäsentyy väärällä kielellä ja tuottaa kourallisen satunnaisia solmuja, joten graafi näyttää täyttyneeltä, vaikka todelliset symbolit puuttuvat. Ilmoita, mitä pääte tarkoittaa reposi kohdalla:

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

Ilmoitus virtaa luokittelun, ekstraktorin valinnan, kieliopin ja resoluution, tuontien, graphify watch-komennon ja AST-välimuistin läpi (tiedosto, joka jäsennetään uudelleen eri kielellä, ei koskaan käytä uudelleen vanhaa merkintää), ja saman .graphifyrc-tiedoston lukevat extract, update, hookit, MCP-palvelin ja /graphify-taito. Kirjoitusvirhe raportoidaan kerran stderriin ja skannaus jatkuu oletuksilla. Miten ilmoitukset vuorovaikuttavat välimuistin, inkrementaalisten uudelleenrakennusten ja tuontien resoluution kanssa: Konfiguraatio.

Tiimin asetukset¶

Committaa tai jaa graafi, niin koko tiimisi kyselee samaa kontekstia, ja katselmoi pull requestit graafikontekstin kanssa. Katso Jaa konteksti tiimisi kanssa ja Katselmoi pull requestit.

Graafin käyttö suoraan¶

AI-avustajasi lisäksi voit kysellä graph.json-tiedostoa suoraan CLI:stä komennoilla graphify query, graphify path ja graphify explain. Nimi, joka vastaa useita solmuja, hylätään listaamalla ehdokkaat sen sijaan, että arvattaisiin. Skriptit voivat lukea lopputuloksen paluukoodista: 0 vastaus, 3 monitulkintainen nimi, 4 ei vastaavaa solmua. Katso Esitä parempia graafikysymyksiä ja kyselyviite.

Ympäristömuuttujat¶

Taustajärjestelmiä, API-avaimia, hook-käyttäytymistä ja viritystä ohjataan ympäristömuuttujilla. Täysi taulukko: Konfiguraatio.

Yksityisyys¶

• Kooditiedostot: käsitellään paikallisesti tree-sitterin kautta. Mikään ei poistu koneeltasi. Pelkkää koodia sisältävä korpus ei vaadi API-avainta: graphify extract toimii täysin offline-tilassa. Sekarepossa lisää --code-only indeksoidaksesi vain koodin ja ohittaaksesi dokumentit/PDF-tiedostot/kuvat, jotka muuten tarvitsisivat LLM:ää.
• Video / ääni: litteroidaan paikallisesti faster-whisperillä. Mikään ei poistu koneeltasi.
• Dokumentit, PDF-tiedostot, kuvat: lähetetään AI-avustajallesi semanttiseen ekstraktioon (/graphify-taidon kautta, käyttäen mallia, jota IDE-istuntosi ajaa). Headless graphify extract vaatii GEMINI_API_KEY / GOOGLE_API_KEY (Gemini), MOONSHOT_API_KEY (Kimi), ANTHROPIC_API_KEY (Claude), OPENAI_API_KEY (OpenAI), DEEPSEEK_API_KEY (DeepSeek), käynnissä olevan Ollama-instanssin (OLLAMA_BASE_URL), AWS-tunnistetiedot vakiomuotoisen tarjoajaketjun kautta (Bedrock - ei API-avainta tarvita, käyttää IAM:ia), tai claude-CLI-binäärin (Claude Code - ei API-avainta tarvita, käyttää Claude-tilaustasi). --dedup-llm-lippu käyttää samaa avainta.
• Datan sijainti: graphify extract tunnistaa automaattisesti, mitä tarjoajaa käyttää sen perusteella, mikä API-avain on asetettu (prioriteetti: Gemini → Kimi → Claude → OpenAI → DeepSeek → Azure → Bedrock → Ollama). Koodille, jolla on datan sijaintivaatimuksia, käytä --backend ollama (täysin paikallinen) tai anna eksplisiittinen --backend-lippu. Kimi (MOONSHOT_API_KEY) reitittää Moonshot AI:n palvelimille Kiinassa.
• Ei telemetriaa, ei käytön seurantaa, ei analytiikkaa.
• Kyselyjen lokitus: jokainen graphify query-, graphify path-, graphify explain- ja MCP query_graph-kutsu lokitetaan tiedostoon ~/.cache/graphify-queries.log JSON Lines -muodossa (aikaleima, kysymys, korpus, palautetut solmut, kesto). Täydellisiä aligraafivastauksia ei tallenneta oletuksena. Aseta GRAPHIFY_QUERY_LOG_DISABLE=1 kieltäytyäksesi, tai GRAPHIFY_QUERY_LOG=/dev/null vaimentaaksesi poistamatta koodipolkua käytöstä.

Vianetsintä¶

Yleiset asennus- ja ekstraktio-ongelmat ja niiden korjaukset: Vianetsintä.

Täydellinen komentoviite¶

Jokainen komento ja lippu, esimerkkien kera: CLI-viite.

Lue lisää¶

• docs.graphify.com: täysi dokumentaatio: oppaat, komentoviite ja integraatiot
• Miten se toimii: ekstraktioputki, yhteisöjen havaitseminen, luottamuspisteytys, benchmarks
• ARCHITECTURE.md: moduulien erittely, miten lisätä kieli
• Valinnaiset integraatiot: Docker MCP Toolkit + SQLite
• The Memory Layer: kirja graphifyn taustalla olevista ideoista, arkkitehtuuri päästä päähän

Graphify Cloud¶

Graphify Cloud on aina päällä oleva kerros, joka on rakennettu graphifyn päälle. Sen sijaan, että rakentaisit graafin tarvittaessa uudelleen kansiokohtaisesti, se pitää yhtä elävää graafia koko ohjelmistokehityksen elinkaaren läpi:

• 80% vähemmän tokeneita: aina päällä oleva muisti tarkoittaa, että agenttisi lopettavat koodikannan uudelleenlukemisen ja -selittämisen joka istunnossa.
• Monorepo ja repojen välinen: yksi yhdistetty graafi jokaisen palvelun ja repositorion yli, ei graafia kansiota kohden.
• Formaali verifiointi: tarkista arkkitehtuuri- ja riippuvuusinvariantit elävää graafia vasten.
• Koodikatselmointi lintuperspektiivistä SDLC:ääsi: näe, miten muutos leviää läpi koko järjestelmän ennen kuin merge:aat.
• SDLC-liittimet: tuo mukaan Sentry, Jira ja muita, niin että häiriöt, tiketit ja koodi elävät yhdessä graafissa.
• Aina päällä: päivittyy jatkuvasti taustalla koodin, dokumenttien ja kokousten yli.

Aloita ilmainen 14 päivän kokeilu osoitteessa app.graphify.com →

Osallistuminen¶

Osallistumiset ovat tervetulleita. Katso CONTRIBUTING.md kehitysympäristön, testi- ja CI-pariteettikomentojen, git-työnkulun ja sen osalta, mikä tekee vahvan osallistumisen (työstetyt esimerkit ja ekstraktiovikailmoitukset ovat hyödyllisimpiä). Arkkitehtuuri ja miten lisätä kieli: ARCHITECTURE.md.

Uusi täällä? Sano hei Discordissa tai GitHub Discussionsissa.

Osallistujat¶

Tehty työkalulla contrib.rocks.

Käännökset¶

README on saatavilla 32 kielellä. Käytä tämän tiedoston yläreunan kielivalitsinta lukeaksesi sen omallasi, tai selaa docs/translations/. Parantaaksesi käännöstä tai lisätäksesi uuden, avaa pull request vastaavaa tiedostoa vasten siellä.

graphifyn päälle rakentaminen¶

Rakennatko jotain graphify-ekosysteemissä? Sitä kannustetaan. Jos projektisi käyttää nimessään "graphify" (esimerkiksi graphify-dashboard tai graphify-action), lisää READMEesi lyhyt huomautus, joka selventää, että se on yhteisön rakentama eikä sidoksissa Graphify Labsiin tai sen hyväksymä. "graphify" ja graphify-logo ovat Graphify Labsin tavaramerkkejä; älä käytä niitä tavalla, joka antaa ymmärtää virallista asemaa.

Yhteisö ja linkit¶