11 ms·
Creator here. Six Degrees of Wikipedia is a side project I've been sporadically hacking on over the past few years. It was an interesting technical challenge an
by jwngr 9y ago
Creator here. Six Degrees of Wikipedia is a side project I've been sporadically hacking on over the past few years. It was an interesting technical challenge and it's fun to play with the end result. Here's the tech stack:
* Frontend: React (Create React App)
* Backend: Python Flask
* Database: SQLite
* Web (frontend) hosting: Firebase Hosting
* Server (backend) hosting: Google Compute Engine (it runs fine on a tiny f1-micro instance)
All the code is open source[1] and I'm happy to answer any questions about building or maintaining it!
[1] https://github.com/jwngr/sdow https://github.com/jwngr/sdow
- Trufa 9y agoAm I not understanding something? When I linked Obama to Uruguay, Myanmar came up (the only surprising one). https://www.sixdegreesofwikipedia.com/?source=Uruguay&target=Barack%20Obama https://www.sixdegreesofwikipedia.com/?source=Uruguay&target... I went to the Uruguayan wiki page and found nothing on Myanmar and nothing relating to Uruguay on the Myanmar page. Awesome project btw, great idea.
- jwngr 9y ago[copy of answer from below] The Wikipedia database doesn't differentiate links which appear in the main article versus in the sources or categories sections. It's possible one of the intermediate links is in there. You sometimes need to do a CTRL+f in "View Source" to find the link. Also, the latest Wikipedia dump is from February 2nd, so it's possible the link has been deleted since that date. I'll regenerate my database when the new dump lands in early March.
- spiznnx 9y agoIt's a directed graph. Your source is Uruguay and your destination is Obama. You'll find Obama on the midpoints. Opposite direction: no Myanmar https://www.sixdegreesofwikipedia.com/?source=Uruguay&target=Barack%20Obama https://www.sixdegreesofwikipedia.com/?source=Uruguay&target...
- mkagenius 9y agoWhich is kind of weird since he is using bi directional BFS.
- jwngr 9y agoI do a bi-directional BFS, but the search from the target node traverses incoming links as opposed to outgoing links. That's why I have to store both in the `links` table[1]. [1] https://github.com/jwngr/sdow/blob/f0b5a9ebe47ea0eca49d8220a1667a5c8e6a3af9/database/createLinksTable.sql#L6-L7 https://github.com/jwngr/sdow/blob/f0b5a9ebe47ea0eca49d8220a...
- colemannugent 9y agoYour notification for having JS disabled made me chuckle. One suggestion I have is that the graph view seems to clutter up pretty fast. Maybe have a slider that increases the length of the lines between the vertices. Also, a SVG export would be cool for visualizing related concepts.
- jwngr 9y agoGlad you found one of the Easter eggs :D The graph visualization / performance is definitely not ideal. I spent a ton of time trying to make d3 more performant and layout the graph more nicely, but ultimately I just had to cut my losses and go with what I had. I do think there is room for improvement and I'll look into your suggestion, which is something I didn't consider. SVG export is also a great idea!
- thrownaway954 9y agomake it so that if I visit the page and just click the "go" button, it will use the placeholder examples as the start and end points. i did this and got an error message stating "You'll probably want to choose the start and end pages before you hit that." that was annoying. the placeholders that were auto chosen were actually really interesting.
- jwngr 9y agoThis has been fixed[1] and should behave in a more intuitive way now. Thanks for the suggestion! [1] https://github.com/jwngr/sdow/commit/6e42e06488a592784e5d3d221fba81adbbe0259e https://github.com/jwngr/sdow/commit/6e42e06488a592784e5d3d2...
- thrownaway954 9y agoawesome!!! you rock!!!
- ng-user 9y ago'Please' and 'thank you' go a long when requesting additional features for an OSS project.
- deleted 9y ago[deleted]
- mung 9y agoIt's a suggestion, not a request and a good one at that. So who should be saying 'thank you' here (if anyone)?
- prophesi 9y agoTact.
- CRConrad 9y agoOr "Tack". ;-) No, of course the word you're after is "tact". (And even as a foreigner, it annoys the heck out of me when people mix them up [which you didn't!], ususally as in "take another tact" when they mean "take another tack" [where 'tack' is a originally a sailing term for flipping the sail to the other side of the boat when going against the wind, IIUC; so the expression means "go in a slightly different direction"].) I'm just riffing on Heikki's remark about foreign languages: In my primary language, Swedish, "tack" means "thank you" but is also often used for Eng. "please" -- so "Kan du ... , tack?" means "Could you ... , please?". https://en.wikipedia.org/wiki/Tacking_(sailing) https://en.wikipedia.org/wiki/Tacking_(sailing)
- orf 9y agoDamn, you beat me to it! I've been hacking on something similar for the longest time. Thanks for sharing your code!
- VikingIV 9y agoWere either of your creations around since ~2012? I recall someone sharing this very concept in a room on turntable.fm, except it would list it's discovery in real-time as an ordered list. I've been racking my memory for 2 years trying to find a link again, but here we are!
- vanderZwan 9y agoI had a conversation with a friend a few weeks ago that surely this already exists, and if not that someone should make this. Any plans to filter by mutual paths?
- jwngr 9y agoI'm definitely not the first to think of it or build a tool for it (lots of similar projects gave me inspiration), but I think I'm the first to make it really fast and with a nice usable UI. And to actually open source the code so others can build it themselves. Can you tell me more about what you mean by filtering by mutual paths?
- stirner 9y agoI implemented this pretty naively a while back [1]. I was interested in how yours was so fast. I expected some sort of complex heuristic; cool to see that your solution is straightforward! [1] https://github.com/wwalexander/wikipath https://github.com/wwalexander/wikipath
- kozziollek 9y agoI think GP wanted to find paths in both directions: X -> A -> B -> Y and Y -> C -> D -> X. Possibly where A = D and B = C.
- vanderZwan 9y ago> Can you tell me more about what you mean by filtering by mutual paths? I should have said mutual connections, my apologies. So if article A connects to B and article B also connects to A. I suppose you could do this mostly client-side, all you need is two searches (one the reverse of the other) and an intersection of the resulting graphs, no?
- bluetwo 9y agoI would like to hear a little more on how you organized the search and what you are pre-processing and what you calculate on-the-fly. Thanks.
- jwngr 9y agoThe database creation script[1] has a lot of Unix junk in it, but reading through the comments and echo statements should give you an idea of what it does. The end result is a SQLite database with a size of about 9 GB which has four tables, the schema of which are described in the README[2]. The big things that are precomputed are redirects are "auto-followed" to reduce the total graph size and all incoming and outgoing links are stored in a |-separated string for each page (in the `links` table). Every time a query is made, a bi-directional breadth-first search[3] is run which uses the |-separated incoming and outgoing links and runs a fairly standard BFS algorithm. A lot of the hard work was precomputed, which minimizes the number of required database queries and makes each search respond fairly quickly. [1] https://github.com/jwngr/sdow/blob/master/database/buildDatabase.sh https://github.com/jwngr/sdow/blob/master/database/buildData... [2] https://github.com/jwngr/sdow#database-creation-process https://github.com/jwngr/sdow#database-creation-process [3] https://github.com/jwngr/sdow/blob/master/sdow/breadth_first_search.py https://github.com/jwngr/sdow/blob/master/sdow/breadth_first...
- bluetwo 9y agoThanks!
- sinaa 9y agoGreat work! Do you simply do a BFS to find the shortest paths? If so, are you doing any tricks to avoid the path explosion problem?
- ryan_j_naughton 9y agoIt is bidirectional BFS: https://github.com/jwngr/sdow/blob/master/sdow/breadth_first_search.py https://github.com/jwngr/sdow/blob/master/sdow/breadth_first... A* can't be used given that path cost or expected remaining distance is unknown. Any ideas on how such an algorithm could be used without precomputing the entire graph?
- jwngr 9y agoThanks! I'm glad you asked. I actually do what I call a bi-directional breadth first search[1]. The gist of it is that instead of just doing a BFS from the source node until I reach the target node, I do a reverse BFS from the target node as well and wait until the two searches overlap. That helps with the exploding path problem, although that still becomes an issue for longer paths (>= 5 degrees generally). I also pre-compute all the incoming and outgoing links for each page when I create the database[2] so I don't need to do that upon every search, which resulted in a huge performance boost. [1] https://github.com/jwngr/sdow/blob/a2699dc95d884ec64a46416307bebd9c58f76412/sdow/breadth_first_search.py#L36 https://github.com/jwngr/sdow/blob/a2699dc95d884ec64a4641630... [2] https://github.com/jwngr/sdow/blob/a2699dc95d884ec64a46416307bebd9c58f76412/database/buildDatabase.sh#L217-L238 https://github.com/jwngr/sdow/blob/a2699dc95d884ec64a4641630...
- vorpalhex 9y agoWhen I was first playing with this, I actually really expected you to be using an expensive performant solution like neo4j. When I read that you were using sqlite, I didn't believe it at first and thought it was a mistype from dev until I looked over the source. That's an impressive and well thought out performance enhancement, and that the app runs so blazingly fast on sqlite is very impressive.
- 9y ago
- examancer 9y agoThe UX design is very well executed. This feels so polished. The floating graphs in the background, the individual paths under the chart, etc. It's all very well done with lots of little flourishes. Makes me want to up my game. Thanks for sharing.
- Teichopsia 9y agoApparently an idiot here. What is the difference between web hosting and server hosting? The way my mind interprets that stack is the database is hosted on firebase while the page is hosted on the server? Edit: Thank you all for the explanation. I used to think firebase was used as a database. I didn't know one could host front end files there. It seems I still have a long ways to go :)
- servercobra 9y agoFirebase Hosting is a simple way to host frontend code, similar to (but a little easier than) using S3 to serve the frontend. Since the database is SQLite, it seems like the backend and DB are hosted on GCE.
- jwngr 9y agoNo, not an idiot. I didn't use the best terms. I updated them to say "Web (frontend) hosting" which are my static files (the HTML, JS, CSS) which is deployed to Firebase Hosting and "Server (backend) hosting" which is my backend Python Flask web server which is deployed to Google Compute Engine (GCE). So, the website files are hosted on Firebase while the backend is hosted on GCE. The database is actually not hosted; it's just a SQLite file stored on my GCE instance.
- ehsankia 9y agoI assumed the other way around. Firebase gives you the webpage, but when you send a query, it is sent to Compute Engine to calculate all the paths and sent back to the frontend to render.
- jnbiche 9y agoWhy not use a graph database like Neo4j instead of SQLite? This seems like the perfect use case. Is it because of the resources required to run one versus SQLite?
- jwngr 9y agoI actually had a friend suggest it to me and the Neo4j docs happen to be one of the many tabs I currently have open. I was already so far into using SQLite for this project and I wanted to ship it, so I decided to stick with what I had. I would be interested to see how Neo4j performs with such a big dataset (the resulting SQLite file is around 9 GB with nearly 6 million nodes and 500 billion links). I was a bit worried that Neo4j wouldn't be able to scale to a graph of that size, but that is a completely untested and ignorant opinion. If you have any experience with Neo4j, I'd love to hear your thoughts.
- tokenizerrr 9y agoI've used neo4j before and it likes to consume a lot of memory.
- jnbiche 9y agoI've only played around with Neo4j, but it looks like Neo4j 3.0 could handle your node and edge count (although not earlier versions). Your app likely would have been easier to write with python/Neo4j than python/SQLite due to Neo4j's query language (incidentally, Neo4j also prefers to use bidirectional BFS for shortest path, and executing the search is a very simple query similar to an SQL query). Neo4j would possibly perform better as well (I'm not sure about that, given SQLite is pretty optimized for reads). However, as the neighboring comment states, Neo4j is quite resource-intensive. It wouldn't work on any kind of micro instance, I'm pretty sure.
- dreamfactored 9y agoMaybe the Neo4j guys would be into helping as they are quite into marketing. This could be a neat showcase speaking to both business and tech types.
- 9y ago
- larkeith 9y agoI've not yet had a chance to look over the code (in case it's already there or infeasible due to architecture), but you may wish to consider caching prior queries and their results - this seems like the type of service that would be likely to have certain paths shared widely, such as the first few top-level comments on this post.
- jwngr 9y agoI'm not sure caching would help a ton given how I structure the data and do my searches in batches of pages, not for individual pages. I already do some "caching" by precomputing all incoming and outgoing links for each page when I create the database, which, as you would expect, yields a huge performance improvement. A cache certainly would help, but I would expect the hit rate on it to be extremely low, making it not worth the effort. I may have a different opinion after analyzing some of today's results though. Thanks for the suggestion!
- justinlilly 9y agoI've poked at trying to build this multiple times for the last 10 years, but always ended up looking at the wikipedia XML and just balking. The one difference that mine theoretically would have had is that I think it would be rad to include the paragraph you found the link along the edge in the graph, so you could see a little story. Also, excluding years and places to make the routes more "interesting" (e.g. longest path under a limit without cycles).
- unreal37 9y agoSome years ago, I owned sixipedia.com. I never knew what to do with it.... If I still had it, I would have given it to you.
- nathanken 9y agoReally cool. I'm interested to know how the graph is build. Did you use any third party components.
- jwngr 9y agoThank you! The graph is built using vanilla d3, no library on top of it. The code for it lives all in one file, ResultsGraph.js [1]. I pieced together the code from a handful of other attempts online. I am still not 100% pleased with the performance of it with a larger number of nodes (250+), but that seems to be a common complaint with the d3 force simulation layouts. [1] https://github.com/jwngr/sdow/blob/master/website/src/components/ResultsGraph.js https://github.com/jwngr/sdow/blob/master/website/src/compon...
- nathanken 9y agoThanks for your reply.
- reificator 9y agoCould you please add a mode that does the opposite? I've always enjoyed playing 6 degrees myself, so if it gives a link to the first page and names the second page, then only shows the available routes when I'm done, that would be a lot of fun. I have a couple of "hub" articles that I like to use, but I'd like to see how much more effective I could have been with a tool like this. And if it randomizes my start and end like the placeholder text shows, that makes it even easier.
- mintplant 9y agoSounds like https://thewikigame.com https://thewikigame.com
- deleted 9y ago[deleted]
- ysaimanojkumar 9y agoHi jwngr, Thanks for the cool hack. Its nice. How about representing the destination page as a circle around the whole graph, instead of a node? so that all the paths can be drawn in different directions but still reaching the same page. I somehow feel that it might look more beautiful.
- jwngr 9y agoOoh cool idea! That certainly would improve the information density issue. I honestly never considered that at all and have no idea how I'd do it in d3, but I may try to hack it out. Thanks!
- thunderrabbit 9y agoMaybe link all the outside nodes and then tell them to repel each other. If there are only two, it will be weird, but with three or more should work out.?
- sidcool 9y agoThis is pretty cool. It would be great to write a blog around your technical decision making for this project. Thanks!
- drej 9y agoLooks pretty cool - do you have any plans to support subsites other than enwiki?
- jwngr 9y agoPossibly... follow this GitHub issue[1] if you want to be notified about it. [1] https://github.com/jwngr/sdow/issues/11 https://github.com/jwngr/sdow/issues/11
- cvigoe 9y agoLove the idea, and it’s brilliantly executed! Well done. Perhaps I misinterpreted the concept of “degrees of separation”, but I was expecting the site to tell me how to start at page X and get to page Y with the min number of clicks. If you wanted to achieve this, it doesn’t strike me as appropriate to use Bidirectional BFS but IANAL. I did notice that someone pointed out that they get different results by swapping the order of X and Y. This seems pretty surprising? Well done again!
- jwngr 9y agoThanks, glad you enjoyed it! > I was expecting the site to tell me how to start at page X and get to page Y with the min number of clicks. Yup, this is exactly what the site does, and a bi-directional BFS is an efficient way to do it. The special thing about my bi-directional BFS is that I follow outgoing links when searching from the source page while following incoming links when searching from the target page[1]. > I did notice that someone pointed out that they get different results by swapping the order of X and Y. This seems pretty surprising? This is expected, because it is a directed graph, with the links on Wikipedia being in one direction. Just because page A links to page B doesn't mean page B links to page A. [1] https://github.com/jwngr/sdow/blob/master/sdow/breadth_first_search.py https://github.com/jwngr/sdow/blob/master/sdow/breadth_first...
- cvigoe 9y agoI just realized what my confusion was over! https://www.sixdegreesofwikipedia.com/?source=Carnegie%20Mellon%20University&target=St%20Michael%27s%20College%2C%20Dublin https://www.sixdegreesofwikipedia.com/?source=Carnegie%20Mel... I was looking at the results of going from CMU to my little secondary school in Dublin, Ireland. I saw the results and saw that the last page before my Irish school was "College" and assumed it must be wrong, because how could my tiny secondary school be on the Wikipedia page for "College"? But alas, I was wrong!! I just checked and turns out it IS on the college wiki page! I also assumed you were looking at outgoing links for both X and Y - that explains a lot. I am super interested in this, but I have never done any graph theory or searching/planning (I'm EE) - how did you build up all of the incoming links for each wiki page? Are you storing all of this? How much data is that? Thanks for the reply!
- whateveruser 9y agoHey man, just a nitpick. The input fields fudge up when using dark GTK themes, as in text isn't legible unless I select it. Might wanna look into it.
- johnhenry 9y agoGreat project! I wonder if you might be willing to go into more details about what made it an "interesting technical challenge"?
- jwngr 9y agoThe sheer scale of Wikipedia (5 millions pages, half a trillion links) made it difficult to make the searches fast. Simply downloading the Wikipedia database dumps and parsing them into my own database took over a day on my first successful attempt. The site returns most results in just a few seconds despite the giant graph size.
- zapt02 9y agoHow big does the SQLite database get? How do you maintain such great performance? (Other than indexes?)
- jwngr 9y agoThe resulting SQLite database file is currently 8.3 GB, most of which is taken up by the `links` table. The big performance wins are having a handful of indexes (see the .sql files[1] for the database's schema) and preprocessing a lot of data so I don't have to do duplicate work every time a query occurs. For example, instead of the `links` table going from `source_id` to `target_id` and having a ton of rows which have the same `source_id`, I go from `id` to `outgoing_links` (which is a |-separate string of all source page IDs). Computing each page's incoming and outgoing links is the really heavy work and I only do that at database creation time, using a beefy GCP machine with 8 vCPUs, 52 GB RAM, and a 256 GB SSD. It still takes about an hour, but it's a one time cost and means I can run the actual service on a much smaller machine which won't cost me a fortune to maintain. Also, SQLite is just very fast and performant out of the box, so as usual, it's a matter of choosing the right tools for the job. [1] https://github.com/jwngr/sdow/tree/master/database https://github.com/jwngr/sdow/tree/master/database
- techaddict009 9y agoLooks pretty cool. Simple question I have is, are you hitting wikipedia api live? or you have dump of the wikipedia and running through it? If running through dump do you update it regularly or how? Thanks in advance.
- jwngr 9y agoThe autocomplete suggestions hit the live Wikipedia API[1]. The actual search algorithm is on a dump of Wikipedia[2], which I plan to update monthly. [1] https://github.com/jwngr/sdow/blob/f39398d112fecf7b993c64bd4115ba3c1f352209/website/src/components/PageInput.js#L44-L70 https://github.com/jwngr/sdow/blob/f39398d112fecf7b993c64bd4... [2] https://github.com/jwngr/sdow#data-source https://github.com/jwngr/sdow#data-source
- sente 9y agoThus is awesome. Just a heads up - some of the node colors can be difficult to differentiate for people who are red/green colorblind. Very minor, just wanted to mention it though.
- SkylerASmith 9y agoThis is an awesome tool! I'm interested in building a fact checker from a wikipedia graph, and your SDOW seems like a great place to start (I'm intending to use an algorithm inspired from researchers at Indiana University http://journals.plos.org/plosone/article?id=10.1371/journal.pone.0128193 http://journals.plos.org/plosone/article?id=10.1371/journal....). I was wondering if your database has a non-GUI API. Is there a URL or something I can hit to get back JSON or XML as a response?
- jwngr 9y agoI'd prefer you not send any additional load to my server (this is just a side project I'm paying out of pocket for), but you are welcome to download the data yourself. There are instructions in the project README[1] to download the SQLite files I use in the project and I should have documented enough about the schema for you to know what queries to make. I am happy to answer questions via GitHub issues if you have them. [1] https://github.com/jwngr/sdow#get-the-data-yourself https://github.com/jwngr/sdow#get-the-data-yourself
- SkylerASmith 9y agoThat makes sense; thanks for your response!