https://github.com/verdverm/atmunge
ATProtocol tool to backfill, mirror, explore, and analyze the network
https://github.com/verdverm/atmunge
atproto atproto-sync atprotocol
Last synced: 22 days ago
JSON representation
ATProtocol tool to backfill, mirror, explore, and analyze the network
- Host: GitHub
- URL: https://github.com/verdverm/atmunge
- Owner: verdverm
- License: mit
- Created: 2025-07-08T21:42:45.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2026-03-11T19:57:03.000Z (4 months ago)
- Last Synced: 2026-03-12T00:52:32.751Z (4 months ago)
- Topics: atproto, atproto-sync, atprotocol
- Language: Jupyter Notebook
- Homepage:
- Size: 2.47 MB
- Stars: 20
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Blebbit AT Mirror
A collection of tools and utilities for backfilling, mirroring, and analyzing the ATProtocol network.
## Install & Setup
### The CLI
```sh
# get the repo
git clone https://github.com/blebbit/atmunge
cd atmunge
# install the cli
make install
```
### Network backfilling
```sh
# [ you can make a separate working dir if you like ]
# setup the env
cp env-example .env
# start the db for plc/accounts
docker compose up -d db
# run db migrations
atmunge db migrate
```
### AI, Datasci, and Python
```sh
uv sync
```
### Extra Dependencies
Varaious parts of `atmunge` require some extra tools
- docker
- postgresql tools (psql, pg_dump, pg_restore)
If you are backfilling large parts of the network,
you're going to want a big disk(s)
## Munging ATProto
The guides are in the `./docs` directory
- [Backfilling the Network](./docs/backfilling.md)
- [AI Processing & Analysis](./docs/bento.md)