[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-3205":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":47,"readmeContent":48,"aiSummary":49,"trendingCount":16,"starSnapshotCount":16,"syncStatus":17,"lastSyncTime":50,"discoverSource":51},3205,"gun","amark\u002Fgun","amark","An open source cybersecurity protocol for syncing decentralized graph data.","https:\u002F\u002Fgun.eco\u002Fdocs",null,"JavaScript",19053,1240,304,274,0,2,5,23,7,78.08,"Other",false,"master",true,[27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46],"artificial-intelligence","big-data","blockchain","crdt","crypto","cryptography","dapp","database","decentralized","dweb","encryption","end-to-end","graph","machine-learning","metaverse","offline-first","p2p","protocol","realtime","web3","2026-06-12 04:00:16","\u003Cp id=\"readme\">\u003Ca href=\"https:\u002F\u002Fgun.eco\u002F\">\u003Cimg width=\"40%\" src=\"https:\u002F\u002Fcldup.com\u002FTEy9yGh45l.svg\"\u002F>\u003C\u002Fa>\u003Cimg width=\"50%\" align=\"right\" vspace=\"25\" src=\"https:\u002F\u002Fgun.eco\u002Fsee\u002Fdemo.gif\"\u002F>\u003C\u002Fp>\r\n\r\n[![](https:\u002F\u002Fdata.jsdelivr.com\u002Fv1\u002Fpackage\u002Fnpm\u002Fgun\u002Fbadge)](https:\u002F\u002Fwww.jsdelivr.com\u002Fpackage\u002Fnpm\u002Fgun)\r\n![Build](https:\u002F\u002Fgithub.com\u002Famark\u002Fgun\u002Factions\u002Fworkflows\u002Fci.yml\u002Fbadge.svg)\r\n[![Gitter](https:\u002F\u002Fimg.shields.io\u002Fgitter\u002Froom\u002Famark\u002Fgun.js.svg)](http:\u002F\u002Fchat.gun.eco)\r\n\r\n**GUN** is an [ecosystem](https:\u002F\u002Fgun.eco\u002Fdocs\u002FEcosystem) of **tools** that let you build [community run](https:\u002F\u002Fwww.nbcnews.com\u002Ftech\u002Ftech-news\u002Fthese-technologists-think-internet-broken-so-they-re-building-another-n1030136) and [encrypted applications](https:\u002F\u002Fgun.eco\u002Fdocs\u002FCartoon-Cryptography) - like an Open Source Firebase or a Decentralized Dropbox.\r\n\r\nThe [Internet Archive](https:\u002F\u002Fnews.ycombinator.com\u002Fitem?id=17685682) and [100s of other apps](https:\u002F\u002Fgithub.com\u002Famark\u002Fgun\u002Fwiki\u002Fawesome-gun) run GUN in-production.\r\n\r\n + Multiplayer by default with realtime p2p state synchronization!\r\n + Graph data lets you use key\u002Fvalue, tables, documents, videos, & more!\r\n + Local-first, offline, and decentralized with end-to-end encryption.\r\n\r\nDecentralized alternatives to [Zoom](https:\u002F\u002Fwww.zdnet.com\u002Farticle\u002Fera-hatches-meething-an-open-source-browser-based-video-conferencing-system\u002F), [Reddit](https:\u002F\u002Fnotabug.io\u002Ft\u002Fwhatever\u002Fcomments\u002F36588a16b9008da4e3f15663c2225e949eca4a15\u002Fgpu-bot-test), [Instagram](https:\u002F\u002Firis.to\u002F), [Slack](https:\u002F\u002Firis.to\u002F), [YouTube](https:\u002F\u002Fd.tube\u002F), [Stripe](https:\u002F\u002Ftwitter.com\u002Fmarknadal\u002Fstatus\u002F1422717427427647489), [Wikipedia](https:\u002F\u002Fnews.ycombinator.com\u002Fitem?id=17685682), Facebook [Horizon](https:\u002F\u002Ftwitter.com\u002Fmarknadal\u002Fstatus\u002F1424476179189305347) and more have already pushed terabytes of daily P2P traffic on GUN. We are a [friendly community](http:\u002F\u002Fchat.gun.eco\u002F) creating a [free fun future for freedom](https:\u002F\u002Fyoutu.be\u002F1HJdrBk3BlE):\r\n\r\n\u003Ctable>\r\n\u003Ctr>\r\n\u003Ca href=\"https:\u002F\u002Fyoutu.be\u002Fs_m16-w6bBI\">\u003Cimg width=\"31%\" src=\"https:\u002F\u002Fgun.eco\u002Fsee\u002F3dvr.gif\" title=\"3D VR\"\u002F>\u003C\u002Fa>\r\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fcstefanache\u002Fcstefanache.github.io\u002Fblob\u002F06697003449e4fc531fd32ee068bab532976f47b\u002F_posts\u002F2016-08-02-gun-db-artificial-knowledge-sharing.md\">\u003Cimg width=\"31%\" src=\"https:\u002F\u002Fgun.eco\u002Fsee\u002Faiml.gif\" title=\"AI\u002FML\"\u002F>\u003C\u002Fa>\r\n\u003Ca href=\"http:\u002F\u002Fgps.gunDB.io\u002F\">\u003Cimg width=\"31%\" src=\"https:\u002F\u002Fgun.eco\u002Fsee\u002Fgps.gif\" title=\"GPS\"\u002F>\u003C\u002Fa>\r\n\u003C\u002Ftr>\r\n\u003Ctr>\r\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Flmangani\u002Fgun-scape#gun-scape\">\u003Cimg width=\"31%\" src=\"https:\u002F\u002Fgun.eco\u002Fsee\u002Fdataviz.gif\" title=\"Data Viz\"\u002F>\u003C\u002Fa>\r\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Famark\u002Fgun\u002Fwiki\u002FAuth\">\u003Cimg width=\"31%\" src=\"https:\u002F\u002Fgun.eco\u002Fsee\u002Fp2p.gif\" title=\"P2P\"\u002F>\u003C\u002Fa>\r\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FStefdv\u002Fgun-ui-lcd#okay-what-about-gundb-\">\u003Cimg width=\"31%\" src=\"https:\u002F\u002Fgun.eco\u002Fsee\u002Fiot.gif\" title=\"IoT\"\u002F>\u003C\u002Fa>\r\n\u003C\u002Ftr>\r\n\u003Ctr>\r\n\u003Ca href=\"http:\u002F\u002Fchat.gun.eco\">\u003Cimg width=\"31%\" src=\"https:\u002F\u002Fgun.eco\u002Fsee\u002Fvr-world.gif\" title=\"VR World\"\u002F>\u003C\u002Fa>\r\n\u003Ca href=\"https:\u002F\u002Fyoutu.be\u002F1ASrmQ-CwX4\">\u003Cimg width=\"31%\" src=\"https:\u002F\u002Fgun.eco\u002Fsee\u002Far.gif\" title=\"AR\"\u002F>\u003C\u002Fa>\r\n\u003Ca href=\"https:\u002F\u002Fmeething.space\u002F\">\u003Cimg width=\"31%\" src=\"https:\u002F\u002Fgun.eco\u002Fsee\u002Fvideo-conf.gif\" title=\"Video Confernece\"\u002F>\u003C\u002Fa>\r\n\u003C\u002Ftr>\r\n\u003C\u002Ftable>\r\n\r\n## Quickstart\r\n\r\nGUN is *super easy* to get started with:\r\n\r\n - Try the [interactive tutorial](https:\u002F\u002Fgun.eco\u002Fdocs\u002FTodo-Dapp) in the browser (**5min** ~ average developer).\r\n - Or `npm install gun` and run the examples with `cd node_modules\u002Fgun && npm start` (**5min** ~ average developer).\r\n\r\n> **Note:** If you don't have [node](http:\u002F\u002Fnodejs.org\u002F) or [npm](https:\u002F\u002Fwww.npmjs.com\u002F), read [this](https:\u002F\u002Fgithub.com\u002Famark\u002Fgun\u002Fblob\u002Fmaster\u002Fexamples\u002Finstall.sh) first.\r\n> If the `npm` command line didn't work, you may need to `mkdir node_modules` first or use `sudo`.\r\n\r\n- An online demo of the examples are available here: http:\u002F\u002Ftry.axe.eco\u002F\r\n- Or write a quick app: ([try now in a playground](https:\u002F\u002Fjsbin.com\u002Fkadobamevo\u002Fedit?js,console))\r\n```html\r\n\u003Cscript src=\"https:\u002F\u002Fcdn.jsdelivr.net\u002Fnpm\u002Fgun\u002Fgun.js\">\u003C\u002Fscript>\r\n\u003Cscript>\r\n\u002F\u002F import GUN from 'gun'; \u002F\u002F in ESM\r\n\u002F\u002F GUN = require('gun'); \u002F\u002F in NodeJS\r\n\u002F\u002F GUN = require('gun\u002Fgun'); \u002F\u002F in React\r\ngun = GUN();\r\n\r\ngun.get('mark').put({\r\n  name: \"Mark\",\r\n  email: \"mark@gun.eco\",\r\n});\r\n\r\ngun.get('mark').on((data, key) => {\r\n  console.log(\"realtime updates:\", data);\r\n});\r\n\r\nsetInterval(() => { gun.get('mark').get('live').put(Math.random()) }, 9);\r\n\u003C\u002Fscript>\r\n```\r\n- Or try something **mind blowing**, like saving circular references to a table of documents! ([play](http:\u002F\u002Fjsbin.com\u002Fwefozepume\u002Fedit?js,console))\r\n```javascript\r\ncat = {name: \"Fluffy\", species: \"kitty\"};\r\nmark = {boss: cat};\r\ncat.slave = mark;\r\n\r\n\u002F\u002F partial updates merge with existing data!\r\ngun.get('mark').put(mark);\r\n\r\n\u002F\u002F access the data as if it is a document.\r\ngun.get('mark').get('boss').get('name').once(function(data, key){\r\n  \u002F\u002F `once` grabs the data once, no subscriptions.\r\n  console.log(\"Mark's boss is\", data);\r\n});\r\n\r\n\u002F\u002F traverse a graph of circular references!\r\ngun.get('mark').get('boss').get('slave').once(function(data, key){\r\n  console.log(\"Mark is the cat's slave!\", data);\r\n});\r\n\r\n\u002F\u002F add both of them to a table!\r\ngun.get('list').set(gun.get('mark').get('boss'));\r\ngun.get('list').set(gun.get('mark'));\r\n\r\n\u002F\u002F grab each item once from the table, continuously:\r\ngun.get('list').map().once(function(data, key){\r\n  console.log(\"Item:\", data);\r\n});\r\n\r\n\u002F\u002F live update the table!\r\ngun.get('list').set({type: \"cucumber\", goal: \"jumping cat\"});\r\n```\r\n\r\nWant to keep building more? **Jump to [THE DOCUMENTATION](#documentation)!**\r\n\r\n# About\r\nFirst & foremost, GUN is **a community of the nicest and most helpful people** out there. So [I want to invite you](http:\u002F\u002Fchat.gun.eco) to come tell us about what **you** are working on & wanting to build (new or old school alike! Just be nice as well.) and ask us your questions directly. :)\r\n\r\n\u003Cp align=\"center\">\u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=oTQXzhm8w_8\">\u003Cimg width=\"250\" src=\"https:\u002F\u002Fimg.youtube.com\u002Fvi\u002FoTQXzhm8w_8\u002F0.jpg\">\u003Cbr\u002F>Watch the 100 second intro!\u003C\u002Fa>\u003C\u002Fp>\r\n\r\nThe GUN ecosystem stack is a collection of independent and modular tools covering everything from [CRDT](https:\u002F\u002Fcrdt.tech\u002F) [conflict resolution](https:\u002F\u002Fgun.eco\u002Fdistributed\u002Fmatters.html), [cryptographic security](https:\u002F\u002Fgun.eco\u002Fdocs\u002FCartoon-Cryptography) & [encryption](https:\u002F\u002Fgun.eco\u002Fdocs\u002FSEA), [radix storage serialization](https:\u002F\u002Fgun.eco\u002Fdocs\u002FRAD), [mesh networking](https:\u002F\u002Fgun.eco\u002Fdocs\u002FDAM) & [routing algorithms](https:\u002F\u002Fgun.eco\u002Fdocs\u002FRouting), to distributed systems [correctness & load testing](https:\u002F\u002Fgithub.com\u002Fgundb\u002Fpanic-server), CPU scheduled [JSON parser](https:\u002F\u002Fgithub.com\u002Famark\u002Fgun\u002Fblob\u002Fmaster\u002Flib\u002Fyson.js) to prevent UI lag, and more!\r\n\r\n\u003Cdiv>\u003Cimg width=\"48%\" src=\"https:\u002F\u002Fgun.eco\u002Fsee\u002Fstack.png\"\u002F>\r\n\u003Cimg width=\"48%\" align=\"right\" src=\"https:\u002F\u002Fgun.eco\u002Fsee\u002Flayers.png\"\u002F>\u003C\u002Fdiv>\r\n\r\nOn that note, let's get some official shout outs covered first:\r\n\r\n### Support\r\n\r\n\u003Cp align=\"center\">\r\nThanks to:\r\n\r\n\u003Ctable>\r\n\u003Ctr>\r\n\u003Ctd vlign=\"center\">\u003Ca href=\"https:\u002F\u002Fmozilla.org\u002Fbuilders\">\u003Cimg height=\"100\" src=\"https:\u002F\u002Fuser-images.githubusercontent.com\u002F1423657\u002F81992335-85346480-9643-11ea-8754-8275e98e06bc.png\">\u003C\u002Fa>\u003C\u002Ftd>\r\n\u003Ctd vlign=\"center\">\u003Ca href=\"http:\u002F\u002Funstoppabledomains.com\u002F\">\u003Cimg src=\"https:\u002F\u002Fgun.eco\u002Fimg\u002Funstoppable.png\">\u003C\u002Fa>\u003C\u002Ftd>\r\n\u003Ctd vlign=\"center\">\u003Ca href=\"https:\u002F\u002Fmask.io\u002F\">\u003Cimg src=\"https:\u002F\u002Fdimensiondev.github.io\u002FMask-VI\u002Fassets\u002FLogo\u002FMB--Logo--CombH-Circle--Blue.svg\" width=\"250\">\u003C\u002Fa>\u003C\u002Ftd>\r\n\u003C\u002Ftr>\r\n\u003Ctr>\r\n\u003Ctd vlign=\"center\">           \u003Ca href=\"https:\u002F\u002Fwww.ajar.org\u002F\">\u003Cimg src=\"https:\u002F\u002Fwww.ajar.org\u002Flogo.png\" height=\"120\">\u003C\u002Fa>\u003C\u002Ftd>\r\n\u003Ctd vlign=\"center\">\u003Ca href=\"https:\u002F\u002Fwallie.io\u002F\">\u003Cimg src=\"https:\u002F\u002Fraw.githubusercontent.com\u002Fgundb\u002Fgun-site\u002Fmaster\u002Fimg\u002Fwallie.png\" width=\"250\">\u003C\u002Fa>\u003C\u002Ftd>\r\n\u003Ctd vlign=\"center\">  \u003Ca href=\"https:\u002F\u002Fghostdrive.com\u002F\">\u003Cimg src=\"https:\u002F\u002Fgun.eco\u002Fimg\u002Fghostdrive.png\" height=\"120\">\u003C\u002Fa>\u003C\u002Ftd>\r\n\u003C\u002Ftr>\r\n\u003C\u002Ftable>\r\n\r\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Frobertheessels\">Robert Heessels\u003C\u002Fa>,\r\n\u003Ca href=\"http:\u002F\u002Fqxip.net\u002F\">Lorenzo Mangani\u003C\u002Fa>,\r\n\u003Ca href=\"https:\u002F\u002Fnlnet.nl\u002F\">NLnet Foundation\u003C\u002Fa>,\r\n\u003Ca href=\"http:\u002F\u002Fgithub.com\u002Fsamliu\">Sam Liu\u003C\u002Fa>,\r\n\u003Ca href=\"http:\u002F\u002Fgithub.com\u002Fddombrow\">Daniel Dombrowsky\u003C\u002Fa>,\r\n\u003Ca href=\"http:\u002F\u002Fgithub.com\u002Fvincentwoo\">Vincent Woo\u003C\u002Fa>,\r\n\u003Ca href=\"http:\u002F\u002Fgithub.com\u002Fcoolaj86\">AJ ONeal\u003C\u002Fa>,\r\n\u003Ca href=\"http:\u002F\u002Fgithub.com\u002Fottman\">Bill Ottman\u003C\u002Fa>,\r\n\u003Ca href=\"http:\u002F\u002Fgithub.com\u002Fmikewlange\">Mike Lange\u003C\u002Fa>,\r\n\u003Ca href=\"http:\u002F\u002Fgithub.com\u002Fctrlplusb\">Sean Matheson\u003C\u002Fa>,\r\n\u003Ca href=\"http:\u002F\u002Fgithub.com\u002Falanmimms\">Alan Mimms\u003C\u002Fa>,\r\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fdfreire\">Dário Freire\u003C\u002Fa>,\r\n\u003Ca href=\"http:\u002F\u002Fgithub.com\u002Fvelua\">John Williamson\u003C\u002Fa>,\r\n\u003Ca href=\"http:\u002F\u002Fgithub.com\u002Ffinwo\">Robin Bron\u003C\u002Fa>,\r\n\u003Ca href=\"http:\u002F\u002Fgithub.com\u002FElieMakhoul\">Elie Makhoul\u003C\u002Fa>,\r\n\u003Ca href=\"http:\u002F\u002Fgithub.com\u002Fmikestaub\">Mike Staub\u003C\u002Fa>,\r\n\u003Ca href=\"http:\u002F\u002Fgithub.com\u002Fbmatusiak\">Bradley Matusiak\u003C\u002Fa>,\r\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsjuxax\">Jeff Cook\u003C\u002Fa>,\r\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fnmauersberg\">Nico\u003C\u002Fa>,\r\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fajartille\">Aaron Artille\u003C\u002Fa>,\r\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftimjrobinson\">Tim Robinson\u003C\u002Fa>,\r\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fhibas123\">Fabian Stamm\u003C\u002Fa>,\r\n\u003Ca href=\"https:\u002F\u002Ftwitter.com\u002Fmikestaub\">Mike Staub\u003C\u002Fa>,\r\n\u003Ca href=\"https:\u002F\u002Fhunterowens.com\u002F\">Hunter Owens\u003C\u002Fa>,\r\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FJacobMillner\">Jacob Millner\u003C\u002Fa>,\r\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fb-lack\">Gerrit Balindt\u003C\u002Fa>,\r\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fgabriellemon\">Gabriel Lemon\u003C\u002Fa>,\r\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fmurageyun\">Murage Martin\u003C\u002Fa>,\r\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Foctalmage\">Jason Stallings\u003C\u002Fa>\r\n\u003C\u002Fp>\r\n\r\n - Join others in sponsoring code: https:\u002F\u002Fwww.patreon.com\u002FgunDB !\r\n - Ask questions: http:\u002F\u002Fstackoverflow.com\u002Fquestions\u002Ftagged\u002Fgun ?\r\n - Found a bug? Report at: https:\u002F\u002Fgithub.com\u002Famark\u002Fgun\u002Fissues ;\r\n - **Need help**? Chat with us: http:\u002F\u002Fchat.gun.eco .\r\n\r\n### History\r\n\r\n[GUN](https:\u002F\u002Fgun.eco) was created by [Mark Nadal](https:\u002F\u002Ftwitter.com\u002Fmarknadal) in 2014 after he had spent 4 years trying to get his collaborative web app to scale up with traditional databases.\r\n\r\n\u003Cimg width=\"250px\" src=\"https:\u002F\u002Fgun.eco\u002Fsee\u002Fproblem.png\" align=\"left\" title=\"pain point\" style=\"margin: 0 1em 1em 0\"> After he realized [Master-Slave database architecture causes one big bottleneck](https:\u002F\u002Fgun.eco\u002Fdistributed\u002Fmatters.html), he (as a complete newbie outsider) naively decided **to question the status quo** and shake things up with controversial, heretical, and contrarian experiments:\r\n\r\n**The NoDB** - no master, no servers, no \"single source of truth\", not built with a real programming language or real hardware, no DevOps, no locking, not *just* SQL or NoSQL but both (**all** - graphs, documents, tables, key\u002Fvalue).\r\n\r\nThe goal was to build a P2P database that could survive living inside **any** browser, and could correctly sync data between **any** device after assuming **any** offline-first activity.\r\n\r\n\u003Cimg src=\"https:\u002F\u002Fgun.eco\u002Fsee\u002Fcompare.png\" title=\"comparison table\">\r\n\r\nTechnically, **GUN is a graph synchronization protocol** with a *lightweight embedded engine*, capable of doing *[20M+ API ops\u002Fsec](https:\u002F\u002Fgun.eco\u002Fdocs\u002FPerformance)* in **just ~9KB gzipped size**.\r\n\r\n## Documentation\r\n\r\n\u003Ctable>\r\n  \u003Ctr>\r\n    \u003Ctd style=\"border: 0;\">\u003Ch3>\u003Ca href=\"https:\u002F\u002Fgun.eco\u002Fdocs\u002FAPI\">API reference\u003C\u002Fa>\u003C\u002Fh3>\u003C\u002Ftd>\r\n    \u003Ctd style=\"border: 0;\">\u003Ch3>\u003Ca href=\"https:\u002F\u002Fgun.eco\u002Fdocs\u002FTodo-Dapp\">Tutorials\u003C\u002Fa>\u003C\u002Fh3>\u003C\u002Ftd>\r\n    \u003Ctd style=\"border: 0;\">\u003Ch3>\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Famark\u002Fgun\u002Ftree\u002Fmaster\u002Fexamples\">Examples\u003C\u002Fa>\u003C\u002Fh3>\u003C\u002Ftd>\r\n  \u003C\u002Ftr>\r\n  \u003Ctr>\r\n    \u003Ctd style=\"border: 0;\">\u003Ch3>\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fbrysgo\u002Fgraphql-gun\">GraphQL\u003C\u002Fa>\u003C\u002Fh3>\u003C\u002Ftd>\r\n    \u003Ctd style=\"border: 0;\">\u003Ch3>\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FPenguinMan98\u002Felectrontest\">Electron\u003C\u002Fa>\u003C\u002Fh3>\u003C\u002Ftd>\r\n    \u003Ctd style=\"border: 0;\">\u003Ch3>\u003Ca href=\"https:\u002F\u002Fgun.eco\u002Fdocs\u002FReact-Native\">React & Native\u003C\u002Fa>\u003C\u002Fh3>\u003C\u002Ftd>\r\n  \u003C\u002Ftr>\r\n  \u003Ctr>\r\n    \u003Ctd style=\"border: 0;\">\u003Ch3>\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsjones6\u002Fvue-gun\">Vue\u003C\u002Fa>\u003C\u002Fh3>\u003C\u002Ftd>\r\n    \u003Ctd style=\"border: 0;\">\u003Ch3>\u003Ca href=\"https:\u002F\u002Fgun.eco\u002Fdocs\u002FSvelte\">Svelte\u003C\u002Fa>\u003C\u002Fh3>\u003C\u002Ftd>\r\n    \u003Ctd style=\"border: 0;\">\u003Ch3>\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FStefdv\u002Fgun-ui-lcd#syncing\">Webcomponents\u003C\u002Fa>\u003C\u002Fh3>\u003C\u002Ftd>\r\n  \u003C\u002Ftr>\r\n  \u003Ctr>\r\n    \u003Ctd style=\"border: 0;\">\u003Ch3>\u003Ca href=\"https:\u002F\u002Fgun.eco\u002Fdocs\u002FCAP-Theorem\">CAP Theorem Tradeoffs\u003C\u002Fa>\u003C\u002Fh3>\u003C\u002Ftd>\r\n    \u003Ctd style=\"border: 0;\">\u003Ch3>\u003Ca href=\"https:\u002F\u002Fgun.eco\u002Fdistributed\u002Fmatters.html\">How Data Sync Works\u003C\u002Fa>\u003C\u002Fh3>\u003C\u002Ftd>\r\n    \u003Ctd style=\"border: 0;\">\u003Ch3>\u003Ca href=\"https:\u002F\u002Fgun.eco\u002Fdocs\u002FPorting-GUN\">How GUN is Built\u003C\u002Fa>\u003C\u002Fh3>\u003C\u002Ftd>\r\n  \u003C\u002Ftr>\r\n  \u003Ctr>\r\n    \u003Ctd style=\"border: 0;\">\u003Ch3>\u003Ca href=\"https:\u002F\u002Fgun.eco\u002Fdocs\u002FAuth\">Crypto Auth\u003C\u002Fa>\u003C\u002Fh3>\u003C\u002Ftd>\r\n    \u003Ctd style=\"border: 0;\">\u003Ch3>\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Famark\u002Fgun\u002Fwiki\u002FAwesome-GUN\">Modules\u003C\u002Fa>\u003C\u002Fh3>\u003C\u002Ftd>\r\n    \u003Ctd style=\"border: 0;\">\u003Ch3>\u003Ca href=\"https:\u002F\u002Fgun.eco\u002Fdocs\u002FRoadmap\">Roadmap\u003C\u002Fa>\u003C\u002Fh3>\u003C\u002Ftd>\r\n  \u003C\u002Ftr>\r\n\u003C\u002Ftable>\r\n\r\nThis would not be possible without **community contributors**, big shout out to:\r\n\r\n**[ajmeyghani](https:\u002F\u002Fgithub.com\u002Fajmeyghani) ([Learn GUN Basics with Diagrams](https:\u002F\u002Fmedium.com\u002F@ajmeyghani\u002Fgundb-a-graph-database-in-javascript-3860a08d873c))**; **[anywhichway](https:\u002F\u002Fgithub.com\u002Fanywhichway) ([Block Storage](https:\u002F\u002Fgithub.com\u002Fanywhichway\u002Fgun-block))**; **[beebase](https:\u002F\u002Fgithub.com\u002Fbeebase) ([Quasar](https:\u002F\u002Fgithub.com\u002Fbeebase\u002Fgun-vuex-quasar))**; **[BrockAtkinson](https:\u002F\u002Fgithub.com\u002FBrockAtkinson) ([brunch config](https:\u002F\u002Fgithub.com\u002FBrockAtkinson\u002Fbrunch-gun))**; **[Brysgo](https:\u002F\u002Fgithub.com\u002Fbrysgo) ([GraphQL](https:\u002F\u002Fgithub.com\u002Fbrysgo\u002Fgraphql-gun))**; **[d3x0r](https:\u002F\u002Fgithub.com\u002Fd3x0r) ([SQLite](https:\u002F\u002Fgithub.com\u002Fd3x0r\u002Fgun-db))**; **[forrestjt](https:\u002F\u002Fgithub.com\u002Fforrestjt) ([file.js](https:\u002F\u002Fgithub.com\u002Famark\u002Fgun\u002Fblob\u002Fmaster\u002Flib\u002Ffile.js))**; **[hillct](https:\u002F\u002Fgithub.com\u002Fhillct) (Docker)**; **[JosePedroDias](https:\u002F\u002Fgithub.com\u002Fjosepedrodias) ([graph visualizer](http:\u002F\u002Facor.sl.pt:9966))**; **[JuniperChicago](https:\u002F\u002Fgithub.com\u002FJuniperChicago) ([cycle.js bindings](https:\u002F\u002Fgithub.com\u002FJuniperChicago\u002Fcycle-gun))**; **[jveres](https:\u002F\u002Fgithub.com\u002Fjveres) ([todoMVC](https:\u002F\u002Fgithub.com\u002Fjveres\u002Ftodomvc))**; **[kristianmandrup](https:\u002F\u002Fgithub.com\u002Fkristianmandrup) ([edge](https:\u002F\u002Fgithub.com\u002Fkristianmandrup\u002Fgun-edge))**; **[Lightnet](https:\u002F\u002Fgithub.com\u002FLightnet)** ([Awesome Vue User Examples](https:\u002F\u002Fglitch.com\u002Fedit\u002F#!\u002Fjsvuegunui?path=README.md:1:0) & [User Kitchen Sink Playground](https:\u002F\u002Fgdb-auth-vue-node.glitch.me\u002F)); **[lmangani](https:\u002F\u002Fgithub.com\u002Flmangani) ([Cytoscape Visualizer](https:\u002F\u002Fgithub.com\u002Flmangani\u002Fgun-scape), [Cassandra](https:\u002F\u002Fgithub.com\u002Flmangani\u002Fgun-cassandra), [Fastify](https:\u002F\u002Fgithub.com\u002Flmangani\u002Ffastify-gundb), [LetsEncrypt](https:\u002F\u002Fgithub.com\u002Flmangani\u002FpolyGun-letsencrypt))**; **[mhelander](https:\u002F\u002Fgithub.com\u002Fmhelander) ([SEA](https:\u002F\u002Fgithub.com\u002Famark\u002Fgun\u002Fblob\u002Fmaster\u002Fsea.js))**; [omarzion](https:\u002F\u002Fgithub.com\u002Fomarzion) ([Sticky Note App](https:\u002F\u002Fgithub.com\u002Fomarzion\u002Fstickies)); [PsychoLlama](https:\u002F\u002Fgithub.com\u002FPsychoLlama) ([LevelDB](https:\u002F\u002Fgithub.com\u002FPsychoLlama\u002Fgun-level)); **[RangerMauve](https:\u002F\u002Fgithub.com\u002FRangerMauve) ([schema](https:\u002F\u002Fgithub.com\u002Fgundb\u002Fgun-schema))**; **[robertheessels](https:\u002F\u002Fgithub.com\u002Fswifty) ([gun-p2p-auth](https:\u002F\u002Fgithub.com\u002Fswifty\u002Fgun-p2p-auth))**; **[rogowski](https:\u002F\u002Fgithub.com\u002Frogowski) (AXE)**; [sbeleidy](https:\u002F\u002Fgithub.com\u002Fsbeleidy); **[sbiaudet](https:\u002F\u002Fgithub.com\u002Fsbiaudet) ([C# Port](https:\u002F\u002Fgithub.com\u002Fsbiaudet\u002Fcs-gun))**; **[Sean Matheson](https:\u002F\u002Fgithub.com\u002Fctrlplusb) ([Observable\u002FRxJS\u002FMost.js bindings](https:\u002F\u002Fgithub.com\u002Fctrlplusb\u002Fgun-most))**; **[Shadyzpop](https:\u002F\u002Fgithub.com\u002FShadyzpop) ([React Native example](https:\u002F\u002Fgithub.com\u002Famark\u002Fgun\u002Ftree\u002Fmaster\u002Fexamples\u002Freact-native))**; **[sjones6](https:\u002F\u002Fgithub.com\u002Fsjones6) ([Flint](https:\u002F\u002Fgithub.com\u002Fsjones6\u002Fgun-flint))**; RIP **[Stefdv](https:\u002F\u002Fgithub.com\u002Fstefdv) (Polymer\u002Fweb components)**; **[zrrrzzt](https:\u002F\u002Fgithub.com\u002Fzrrrzzt) ([JWT Auth](https:\u002F\u002Fgist.github.com\u002Fzrrrzzt\u002F6f88dc3cedee4ee18588236756d2cfce))**; **[xmonader](https:\u002F\u002Fgithub.com\u002Fxmonader) ([Python Port](https:\u002F\u002Fgithub.com\u002Fxmonader\u002Fpygundb))**; \r\n\r\nI am missing many others, apologies, will be adding them soon! This list is infinitely old & way out of date, if you want to be listed in it please make a PR! :)\r\n\r\n## Testing\r\n\r\nYou will need to `npm install -g mocha` first. Then in the gun root folder run `npm test`. Tests will trigger persistent writes to the DB, so subsequent runs of the test will fail. You must clear the DB before running the tests again. This can be done by running `rm -rf *data*` command in the project directory.\r\n\r\n## Shims\r\n\r\n > These are only needed for NodeJS & React Native, they shim the native Browser WebCrypto API.\r\n\r\nIf you want to use [SEA](https:\u002F\u002Fgun.eco\u002Fdocs\u002FSEA) for `User` auth and security, you will need to install:\r\n\r\n`npm install @peculiar\u002Fwebcrypto --save`\r\n\r\nPlease see [our React Native docs](https:\u002F\u002Fgun.eco\u002Fdocs\u002FReact-Native) for installation instructions!\r\n\r\nThen you can require [SEA](https:\u002F\u002Fgun.eco\u002Fdocs\u002FSEA) without an error:\r\n\r\n```javascript\r\nGUN = require('gun\u002Fgun');\r\nSEA = require('gun\u002Fsea');\r\n```\r\n\r\n## Deploy\r\n\r\n > Note: The default examples that get auto-deployed on `npm start` CDN-ify all GUN files, modules, & storage.\r\n \r\n > Note: Moving forward, AXE will start to automatically cluster your peer into a shared DHT. You may want to disable this to run an isolated network.\r\n \r\n > Note: When deploying a web application using GUN on a cloud provider, you may have to set `CI=false` in your `.env`. This prevents GUN-specific warnings from being treated as errors when deploying your app. You may also resolve this by modifying your webpack config to not try to build the GUN dependencies.\r\n\r\nTo quickly spin up a GUN relay peer for your development team, utilize [Heroku](http:\u002F\u002Fheroku.com), [Docker](http:\u002F\u002Fdocker.com), or any others listed below. Or some variant thereof [Dokku](http:\u002F\u002Fdokku.viewdocs.io\u002Fdokku\u002F), K8s, etc. ! Or use all of them so your relays are decentralized too!\r\n\r\n### Linux\r\n\r\n`SSH` into the home directory of a clean OS install with `sudo` ability. Set any environment variables you need (see below), then do:\r\n\r\n```bash\r\ncurl -o- https:\u002F\u002Fraw.githubusercontent.com\u002Famark\u002Fgun\u002Fmaster\u002Fexamples\u002Finstall.sh | bash\r\n```\r\n\r\n > Read [install.sh](https:\u002F\u002Fgithub.com\u002Famark\u002Fgun\u002Fblob\u002Fmaster\u002Fexamples\u002Finstall.sh) first!\r\n > If `curl` is not found, *copy&paste* the contents of install.sh into your ssh.\r\n\r\nYou can now safely `CTRL+A+D` to escape without stopping the peer. To stop everything `killall screen` or `killall node`.\r\n\r\nEnvironment variables may need to be set like `export HTTPS_CERT=~\u002Fcert.pem HTTPS_KEY=~\u002Fkey.pem PORT=443`. You can also look at a sample [nginx](https:\u002F\u002Fgun.eco\u002Fdocs\u002Fnginx) config. For production deployments, you probably will want to use something like `pm2` or better to keep the peer alive after machine reboots.\r\n\r\n### [Dome](https:\u002F\u002Fwww.trydome.io\u002F)\r\n[Deploy GUN in one-click](https:\u002F\u002Fapp.trydome.io\u002Fsignup?package=gun) with [Dome](https:\u002F\u002Ftrydome.io) and receive a free trial:\r\n\r\n[![Deploy to Dome](https:\u002F\u002Ftrydome.io\u002Fbutton.svg)](https:\u002F\u002Fapp.trydome.io\u002Fsignup?package=gun)\r\n\r\n### [Heroku](https:\u002F\u002Fwww.heroku.com\u002F)\r\n\r\n[![Deploy](https:\u002F\u002Fwww.herokucdn.com\u002Fdeploy\u002Fbutton.svg)](https:\u002F\u002Fheroku.com\u002Fdeploy?template=https:\u002F\u002Fgithub.com\u002Famark\u002Fgun)\r\n\r\n > Heroku deletes your data every 15 minutes, one way to fix this is by adding [cheap storage](https:\u002F\u002Fgun.eco\u002Fdocs\u002FUsing-Amazon-S3-for-Storage).\r\n\r\nOr:\r\n\r\n```bash\r\ngit clone https:\u002F\u002Fgithub.com\u002Famark\u002Fgun.git\r\ncd gun\r\nheroku create\r\ngit push -f heroku HEAD:master\r\n```\r\n\r\nThen visit the URL in the output of the 'heroku create' step, in a browser. Make sure to set any environment config vars in the settings tab.\r\n\r\n### [Zeet.co](https:\u002F\u002Fwww.zeet.co\u002F)\r\n\r\n[![Deploy](https:\u002F\u002Fdeploy.zeet.co\u002Fgun.svg)](https:\u002F\u002Fdeploy.zeet.co\u002F?url=https:\u002F\u002Fgithub.com\u002Famark\u002Fgun)\r\n\r\nThen visit the URL in the output of the 'now --npm' step, in your browser.\r\n\r\n### [Docker](https:\u002F\u002Fwww.docker.com\u002F)\r\n\r\n > Warning: Docker image is community contributed and may be old with missing security updates, please check version numbers to compare.\r\n\r\n[![Docker Automated build](https:\u002F\u002Fimg.shields.io\u002Fdocker\u002Fautomated\u002Fgundb\u002Fgun.svg)](https:\u002F\u002Fhub.docker.com\u002Fr\u002Fgundb\u002Fgun\u002F) [![](https:\u002F\u002Fimages.microbadger.com\u002Fbadges\u002Fimage\u002Fgundb\u002Fgun.svg)](https:\u002F\u002Fmicrobadger.com\u002Fimages\u002Fgundb\u002Fgun \"Get your own image badge on microbadger.com\") [![Docker Pulls](https:\u002F\u002Fimg.shields.io\u002Fdocker\u002Fpulls\u002Fgundb\u002Fgun.svg)](https:\u002F\u002Fhub.docker.com\u002Fr\u002Fgundb\u002Fgun\u002F) [![Docker Stars](https:\u002F\u002Fimg.shields.io\u002Fdocker\u002Fstars\u002Fgundb\u002Fgun.svg)](https:\u002F\u002Fhub.docker.com\u002Fr\u002Fgundb\u002Fgun\u002F)\r\n\r\nPull from the [Docker Hub](https:\u002F\u002Fhub.docker.com\u002Fr\u002Fgundb\u002Fgun\u002F) [![](https:\u002F\u002Fimages.microbadger.com\u002Fbadges\u002Fcommit\u002Fgundb\u002Fgun.svg)](https:\u002F\u002Fmicrobadger.com\u002Fimages\u002Fgundb\u002Fgun). Or:\r\n\r\n```bash\r\ndocker run -p 8765:8765 gundb\u002Fgun\r\n```\r\n\r\nOr build the [Docker](https:\u002F\u002Fdocs.docker.com\u002Fengine\u002Finstallation\u002F) image locally:\r\n\r\n```bash\r\ngit clone https:\u002F\u002Fgithub.com\u002Famark\u002Fgun.git\r\ncd gun\r\ndocker build -t myrepo\u002Fgundb:v1 .\r\ndocker run -p 8765:8765 myrepo\u002Fgundb:v1\r\n```\r\n\r\nOr, if you prefer your Docker image with metadata labels (Linux\u002FMac only):\r\n\r\n```bash\r\nnpm run docker\r\ndocker run -p 8765:8765 username\u002Fgun:git\r\n```\r\n\r\nThen visit [http:\u002F\u002Flocalhost:8765](http:\u002F\u002Flocalhost:8765) in your browser.\r\n\r\n## License\r\n\r\nDesigned with ♥ by Mark Nadal, the GUN team, and many amazing contributors.\r\n\r\nOpenly licensed under [Zlib \u002F MIT \u002F Apache 2.0](https:\u002F\u002Fgithub.com\u002Famark\u002Fgun\u002Fblob\u002Fmaster\u002FLICENSE.md).\r\n\r\n[![FOSSA Status](https:\u002F\u002Fapp.fossa.io\u002Fapi\u002Fprojects\u002Fgit%2Bhttps%3A%2F%2Fgithub.com%2Famark%2Fgun.svg?size=large)](https:\u002F\u002Fapp.fossa.io\u002Fprojects\u002Fgit%2Bhttps%3A%2F%2Fgithub.com%2Famark%2Fgun?ref=badge_large)\r\n\r\n[YouTube](https:\u002F\u002Fwww.youtube.com\u002Fchannel\u002FUCQAtpf-zi9Pp4__2nToOM8g) . [Twitter](https:\u002F\u002Ftwitter.com\u002Fmarknadal)\r\n","GUN是一个开源的网络安全协议，用于同步去中心化的图数据。其核心功能包括默认支持多人实时P2P状态同步、支持多种数据类型（如键值对、表格、文档、视频等）的图数据结构，以及本地优先、离线可用和端到端加密的特性。GUN适用于需要构建社区驱动且加密的应用场景，比如分布式存储解决方案、去中心化社交平台或安全通信工具。此外，它还非常适合那些希望减少对中心化服务依赖并提高用户隐私保护水平的开发者使用。","2026-06-11 02:52:50","top_language"]