osome-iu / osomemastodon

This dashboard enables users to efficiently conduct query searches across different Mastodon instances, facilitating data collection and analysis.

Introduction

This Dashboard seeks to make retrieving data from across different mastodon servers easier for the purposes of research. The dashboard currently processing these API's and visualize them in the frontend.

• Instance - Get Mastodon Instances API
• Status - Search by keyword API
• Status - Most recent by hashtag API
• Most recent for instance API
• Status - Single status by Id API
• Accounts - Search by keyword
• Accounts - Single Account by Id
• Get Hashtag metadata

Project Structure

• Backend: A flask application that leverages the official mastodon api to retrieve data and manipulate the data.
• Frontend: A vue.js app that makes it easier for a user to perform a search query and observe the results.

How to run the project.

In order to run the project, please clone to project to your local machine. Then separately run the frontend and backend of the project as below.

• Frontend:

1. Check your terminal into the frontend folder.
2. Install necessary npm packages. Run npm i.
3. Serve your vue app by running npm run serve.

• Backend:

1. Check your terminal into the backend folder.
2. Install necessary pip packages. Run pip install -r requirements.txt.
3. Run your flask app by running flask run --port <desired_port_number>.

Note

• You can access the API documentation here
• The Mastodon dashboard is live on osome mastodon