graphsight 0.1.0__tar.gz

graphsight-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arush Karnatak
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

graphsight-0.1.0/MANIFEST.in

@@ -0,0 +1,2 @@
+recursive-include graphsight/dist *
+include LICENSE

graphsight-0.1.0/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: graphsight
+Version: 0.1.0
+Summary: Local viewer for agent retrieval traces — open a trace_state.json in the Graphsight Studio with one command, no backend.
+Author: Arush Karnatak
+License: MIT
+Project-URL: Repository, https://github.com/Kcodess2807/graphsight
+Project-URL: Documentation, https://github.com/Kcodess2807/graphsight/tree/main/graphsight
+Keywords: tracing,observability,rag,retrieval,agents,visualization,langgraph
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Debuggers
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# graphsight
+
+**Open an agent retrieval trace in your browser with one command.**
+
+```bash
+pip install graphsight
+graphsight path/to/trace_state.json
+```
+
+That's it — a local server starts (stdlib only, zero dependencies), your
+browser opens, and the Graphsight Studio renders the trace: the retrieved
+entities as a graph, relational edges between them, per-item scores, and the
+execution timeline of the run that produced it. No backend, no account, no
+telemetry — nothing leaves localhost.
+
+## Where traces come from
+
+Any tool that emits the Studio's `TraceState` JSON. Today that's:
+
+- [`graphsight-langgraph`](../graphsight-langgraph) — trace any LangGraph agent
+  with one callback handler:
+
+  ```bash
+  pip install "graphsight-langgraph[example]"
+  graphsight-github-trace langchain-ai/langgraph "who fixed the recent streaming bugs?"
+  graphsight graphsight_out/trace_state.json
+  ```
+
+- The full TraceRAG engine (this repo) — its `/api/trace` responses are the
+  same shape.
+
+LlamaIndex and raw-OTel adapters are planned; they'll emit the same schema.
+
+## CLI
+
+```
+graphsight [trace_state.json] [--port 4630] [--no-browser]
+```
+
+- With a trace file: serves it and opens `/memory/import?src=…` — the Studio
+  auto-loads it.
+- Without: opens the import page, where you can drag-and-drop or paste JSON.
+
+## How it's built
+
+The package bundles a static build of the Studio UI (Vite + React + React
+Flow) and serves it with Python's stdlib `http.server` — which is why the
+dependency list is empty. The UI source lives in
+[`frontend/`](../frontend) in the main repo; to refresh the bundle:
+
+```bash
+cd frontend && npm run build
+rm -rf ../graphsight/graphsight/dist
+cp -r dist ../graphsight/graphsight/dist
+```

graphsight-0.1.0/README.md

@@ -0,0 +1,55 @@
+# graphsight
+
+**Open an agent retrieval trace in your browser with one command.**
+
+```bash
+pip install graphsight
+graphsight path/to/trace_state.json
+```
+
+That's it — a local server starts (stdlib only, zero dependencies), your
+browser opens, and the Graphsight Studio renders the trace: the retrieved
+entities as a graph, relational edges between them, per-item scores, and the
+execution timeline of the run that produced it. No backend, no account, no
+telemetry — nothing leaves localhost.
+
+## Where traces come from
+
+Any tool that emits the Studio's `TraceState` JSON. Today that's:
+
+- [`graphsight-langgraph`](../graphsight-langgraph) — trace any LangGraph agent
+  with one callback handler:
+
+  ```bash
+  pip install "graphsight-langgraph[example]"
+  graphsight-github-trace langchain-ai/langgraph "who fixed the recent streaming bugs?"
+  graphsight graphsight_out/trace_state.json
+  ```
+
+- The full TraceRAG engine (this repo) — its `/api/trace` responses are the
+  same shape.
+
+LlamaIndex and raw-OTel adapters are planned; they'll emit the same schema.
+
+## CLI
+
+```
+graphsight [trace_state.json] [--port 4630] [--no-browser]
+```
+
+- With a trace file: serves it and opens `/memory/import?src=…` — the Studio
+  auto-loads it.
+- Without: opens the import page, where you can drag-and-drop or paste JSON.
+
+## How it's built
+
+The package bundles a static build of the Studio UI (Vite + React + React
+Flow) and serves it with Python's stdlib `http.server` — which is why the
+dependency list is empty. The UI source lives in
+[`frontend/`](../frontend) in the main repo; to refresh the bundle:
+
+```bash
+cd frontend && npm run build
+rm -rf ../graphsight/graphsight/dist
+cp -r dist ../graphsight/graphsight/dist
+```

graphsight-0.1.0/graphsight/__init__.py

@@ -0,0 +1,11 @@
+"""graphsight — local viewer for agent retrieval traces.
+
+Usage:
+
+    graphsight path/to/trace_state.json
+
+Serves the bundled Graphsight Studio UI locally and opens the trace in the
+browser. No backend, no accounts, no network calls beyond localhost.
+"""
+
+__version__ = "0.1.0"

graphsight-0.1.0/graphsight/cli.py

@@ -0,0 +1,54 @@
+"""graphsight CLI — open a trace in the bundled Studio UI."""
+from __future__ import annotations
+
+import argparse
+import sys
+import webbrowser
+from pathlib import Path
+from typing import Optional
+
+from .server import TRACE_ROUTE, make_server
+
+
+def main(argv: Optional[list[str]] = None) -> None:
+    for stream in (sys.stdout, sys.stderr):
+        try:
+            stream.reconfigure(encoding="utf-8")  # type: ignore[union-attr]
+        except (AttributeError, OSError):
+            pass
+
+    parser = argparse.ArgumentParser(
+        prog="graphsight",
+        description="Serve the Graphsight Studio locally and open a trace_state.json in it.",
+    )
+    parser.add_argument("trace", nargs="?", type=Path,
+                        help="path to a trace_state.json (optional — omit to open the import page)")
+    parser.add_argument("--port", type=int, default=4630, help="port to serve on (default 4630)")
+    parser.add_argument("--no-browser", action="store_true", help="don't open the browser")
+    args = parser.parse_args(argv)
+
+    trace_path = args.trace.resolve() if args.trace else None
+    if trace_path is not None and not trace_path.is_file():
+        parser.error(f"trace file not found: {trace_path}")
+
+    server = make_server(args.port, trace_path)
+    url = f"http://127.0.0.1:{args.port}/memory/import"
+    if trace_path is not None:
+        url += f"?src={TRACE_ROUTE}"
+
+    print(f"graphsight serving at {url}")
+    if trace_path is not None:
+        print(f"trace: {trace_path}")
+    print("Ctrl+C to stop")
+    if not args.no_browser:
+        webbrowser.open(url)
+    try:
+        server.serve_forever()
+    except KeyboardInterrupt:
+        print("\nbye")
+    finally:
+        server.server_close()
+
+
+if __name__ == "__main__":
+    main()

graphsight-0.1.0/graphsight/dist/assets/arc-282qzf6n.js

@@ -0,0 +1 @@
+import{w as ln,p as un,d as G,e as q,f as z,h as an,g,t as tn,i as K,m as _,j as rn,k as o,n as on,o as sn,q as fn}from"./index-D4UHTbV2.js";function cn(l){return l.innerRadius}function gn(l){return l.outerRadius}function yn(l){return l.startAngle}function dn(l){return l.endAngle}function mn(l){return l&&l.padAngle}function pn(l,h,E,j,v,A,B,u){var I=E-l,i=j-h,n=B-v,d=u-A,a=d*I-n*i;if(!(a*a<g))return a=(n*(h-A)-d*(l-v))/a,[l+a*I,h+a*i]}function V(l,h,E,j,v,A,B){var u=l-E,I=h-j,i=(B?A:-A)/K(u*u+I*I),n=i*I,d=-i*u,a=l+n,s=h+d,f=E+n,c=j+d,C=(a+f)/2,t=(s+c)/2,m=f-a,y=c-s,R=m*m+y*y,T=v-A,P=a*c-f*s,O=(y<0?-1:1)*K(on(0,T*T*R-P*P)),S=(P*y-m*O)/R,k=(-P*m-y*O)/R,w=(P*y+m*O)/R,p=(-P*m+y*O)/R,x=S-C,e=k-t,r=w-C,F=p-t;return x*x+e*e>r*r+F*F&&(S=w,k=p),{cx:S,cy:k,x01:-n,y01:-d,x11:S*(v/T-1),y11:k*(v/T-1)}}function hn(){var l=cn,h=gn,E=z(0),j=null,v=yn,A=dn,B=mn,u=null,I=ln(i);function i(){var n,d,a=+l.apply(this,arguments),s=+h.apply(this,arguments),f=v.apply(this,arguments)-an,c=A.apply(this,arguments)-an,C=rn(c-f),t=c>f;if(u||(u=n=I()),s<a&&(d=s,s=a,a=d),!(s>g))u.moveTo(0,0);else if(C>tn-g)u.moveTo(s*G(f),s*q(f)),u.arc(0,0,s,f,c,!t),a>g&&(u.moveTo(a*G(c),a*q(c)),u.arc(0,0,a,c,f,t));else{var m=f,y=c,R=f,T=c,P=C,O=C,S=B.apply(this,arguments)/2,k=S>g&&(j?+j.apply(this,arguments):K(a*a+s*s)),w=_(rn(s-a)/2,+E.apply(this,arguments)),p=w,x=w,e,r;if(k>g){var F=sn(k/a*q(S)),L=sn(k/s*q(S));(P-=F*2)>g?(F*=t?1:-1,R+=F,T-=F):(P=0,R=T=(f+c)/2),(O-=L*2)>g?(L*=t?1:-1,m+=L,y-=L):(O=0,m=y=(f+c)/2)}var H=s*G(m),J=s*q(m),M=a*G(T),N=a*q(T);if(w>g){var Q=s*G(y),U=s*q(y),W=a*G(R),X=a*q(R),D;if(C<un)if(D=pn(H,J,W,X,Q,U,M,N)){var Y=H-D[0],Z=J-D[1],$=Q-D[0],b=U-D[1],nn=1/q(fn((Y*$+Z*b)/(K(Y*Y+Z*Z)*K($*$+b*b)))/2),en=K(D[0]*D[0]+D[1]*D[1]);p=_(w,(a-en)/(nn-1)),x=_(w,(s-en)/(nn+1))}else p=x=0}O>g?x>g?(e=V(W,X,H,J,s,x,t),r=V(Q,U,M,N,s,x,t),u.moveTo(e.cx+e.x01,e.cy+e.y01),x<w?u.arc(e.cx,e.cy,x,o(e.y01,e.x01),o(r.y01,r.x01),!t):(u.arc(e.cx,e.cy,x,o(e.y01,e.x01),o(e.y11,e.x11),!t),u.arc(0,0,s,o(e.cy+e.y11,e.cx+e.x11),o(r.cy+r.y11,r.cx+r.x11),!t),u.arc(r.cx,r.cy,x,o(r.y11,r.x11),o(r.y01,r.x01),!t))):(u.moveTo(H,J),u.arc(0,0,s,m,y,!t)):u.moveTo(H,J),!(a>g)||!(P>g)?u.lineTo(M,N):p>g?(e=V(M,N,Q,U,a,-p,t),r=V(H,J,W,X,a,-p,t),u.lineTo(e.cx+e.x01,e.cy+e.y01),p<w?u.arc(e.cx,e.cy,p,o(e.y01,e.x01),o(r.y01,r.x01),!t):(u.arc(e.cx,e.cy,p,o(e.y01,e.x01),o(e.y11,e.x11),!t),u.arc(0,0,a,o(e.cy+e.y11,e.cx+e.x11),o(r.cy+r.y11,r.cx+r.x11),t),u.arc(r.cx,r.cy,p,o(r.y11,r.x11),o(r.y01,r.x01),!t))):u.arc(0,0,a,T,R,t)}if(u.closePath(),n)return u=null,n+""||null}return i.centroid=function(){var n=(+l.apply(this,arguments)+ +h.apply(this,arguments))/2,d=(+v.apply(this,arguments)+ +A.apply(this,arguments))/2-un/2;return[G(d)*n,q(d)*n]},i.innerRadius=function(n){return arguments.length?(l=typeof n=="function"?n:z(+n),i):l},i.outerRadius=function(n){return arguments.length?(h=typeof n=="function"?n:z(+n),i):h},i.cornerRadius=function(n){return arguments.length?(E=typeof n=="function"?n:z(+n),i):E},i.padRadius=function(n){return arguments.length?(j=n==null?null:typeof n=="function"?n:z(+n),i):j},i.startAngle=function(n){return arguments.length?(v=typeof n=="function"?n:z(+n),i):v},i.endAngle=function(n){return arguments.length?(A=typeof n=="function"?n:z(+n),i):A},i.padAngle=function(n){return arguments.length?(B=typeof n=="function"?n:z(+n),i):B},i.context=function(n){return arguments.length?(u=n??null,i):u},i}export{hn as d};