Skip to content

sumfacts/sumfacts

Repository files navigation


SumFacts
SumFacts

SumFacts.com - a client-only web application for collaboratively building logical arguments as diagrams that are shared over a peer-to-peer network.

https://github.com/sumfacts/sumfacts/blob/master/public/about-banner.jpeg?raw=true

IPFS IPFS TypeScript Netlify CI Github Issues Github

MotivationFeaturesHow To UseCreditsLicense

Motivation

This is a tool to be used by those who wish to spread information that others might not want to be known. The information can never be attacked because it is distributed. The client is open-source so anyone can access and add to the data. And it is specifically designed for building logical arguments with the aim of educating others and winning arguments.

Features

  • 🕒 Easy-to-use - it's quick to formulate arguments that are clear and stay on-topic. Spend less time fighting with software and more time arguing with people.

  • 📷 Shareable arguments - share arguments simply by copying and pasting a link. Quickly and easily make a point. No need to write lengthy comments anymore. A picture tells a thousand words.

  • 🕵️‍♂️ Truth-finding - find holes in arguments and see where an argument falls flat. Expose logical flaws more easily - ad hominems, hate-speech, confirmation bias, etc...

  • 🕸️ Decentralized/open data - all data is stored on the InterPlanetary File System (IPFS) - a distributed, peer-to-peer network. There is no central point of failure and nothing to attack. All data is freely available to everybody.

  • 📂 Open-source client - anyone can freely download this application, run it and audit it. The data can be viewed and edited by anyone with a computer and an internet connection.

  • 🔗 Standardized and inter-linkable arguments - arguments on all topics share the same format and structure. They can be linked together and webs of information can be made. One argument in turn supports another and so forth. Here you will find the JSON Schema for an Argument in the SumFacts system.

  • 📥 Export/import data - arguments can be exported as JSON and downloaded as image in JPEG format. Store important data offline and add diagrams to presentations for example. Import JSON to recreate arguments stored offline.

Usage

Official website

The easiest way to use SumFacts is at the official website: 👉 SumFacts.com 👈

Running locally

Another way to use SumFacts is by cloning this repository and running it locally on your computer.

The data is all stored in the same place (the IPFS), which means no matter where you create an argument you will be able to see it using this application on any other computer if you have its unique CID.

Therefore, if the official website ever gets attacked or shut down, the data will live on for as long as people have it cached in the IPFS network.

Installation

To clone and run this application, you'll need Git and Node.js (which comes with npm) installed on your computer. From your command line:

# Clone this repository
$ git clone https://github.com/sumfacts/sumfacts

# Go into the repository
$ cd sumfacts

# Install dependencies
$ npm install

Development mode

# Run the app in development mode
$ npm run dev

The app will run at http://localhost:3000 and recompile each time you make changes in the /src directory.

Deploying to production

# Build the app
$ npm run build

Then serve the files in the /build directory.

Credits

This software uses the following open source packages:

License

The MIT License (MIT)

Copyright © 2021 Finn Fitzsimons

About

A client-only web application for collaboratively building logical arguments as diagrams that are shared over a peer-to-peer network.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks