/taaraxtak

A platform for collecting, storing, and visualizing data about geopolitical dimensions of the Internet.

Primary LanguageJupyter NotebookBSD 2-Clause "Simplified" LicenseBSD-2-Clause

taaraxtak

python-workflow

taaraxtak is a platform for collecting, storing, and visualizing data about political dimensions of the Internet. See some context on its motivation.

See a live version at XXX

Install

See INSTALL.md

Run

For local development, start the collection server with

python3 collect.py

You can also run the data collection as separate one-time jobs:

  • python3 run.py w3techs
  • python3 run.py ooni

This makes it suitable to be run from a system cron, rather than as a standalone continuous process.

Then check out your Grafana instance (by default, https://localhost:3000).

To deploy a production environment, see DEPLOY.md

Testing

Tests will require pytest:

pip install pytest

Run tests with

pytest test/*

Optionally, you can run tests with code coverage:

pip install pytest
pip install pytest-cov
pytest test/* --cov=src

Contributing

See CONTRIBUTING.MD.

About the name

taaraxtak (IPA: taːɾaxtak) means "the sky" in the Chochenyo Ohlone language.

Looking up at the sky, I can only see what's above me. Similarly, the Internet is something I can only know partially. The name is meant to remind us to look at what we can see, knowing it's only part of the whole. (When we measure the Internet we are, in more senses than one, looking at the shape of clouds). Remember, everything we learned about the atmosphere started by looking up at the sky. All we ever need is a partial perspective and an open system of thought.

License

BSD 2-Clause