🩸 Painterest

Privacy-respecting, anonymous, NoJS-supporting Pinterest frontend. Based on disinterest.

🌐 Instances

See instances.json file.

✨ Features

• API

  • Search
  • Retrieval of specific pins
    • Basic information (name, description, image and tags)
    • Comments
  • Image proxy
  • Search by tags

• Frontend

  • Homepage
  • Search (NoJS)
  • Search (JS/Infinite scroll)
  • Pins
    • Regular pins
    • Business pins
    • Video pins
    • Pins from other sites
    • Comments

🚀 Deployment

Clone repository:

git clone https://codeberg.org/thirtysix/painterest.git && cd painterest

🐳 With Docker

docker compose up -d

💻 Without containerization

python3 -m venv .venv
. .venv/bin/activate
pip install -r requirements.lock
uvicorn src.main:app --no-access-log --proxy-headers --forwarded-allow-ips '*' --host 0.0.0.0 --port 8889

🛡️ Running behind a reverse proxy

To run the app behind a reverse proxy, ensure that the appropriate proxy headers are added. Below is a sample configuration for NGINX:

location / {
    proxy_pass http://127.0.0.1:8889;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

For Caddy (binary installation), here is a sample Caddyfile configuration:

https://domain.tld {
        reverse_proxy localhost:8889
}

📄 Changelog

See CHANGELOG.md file.

🔧 Development

Install Rye by following the installation guide.

Use rye sync to install dependencies and required Python version.

Use rye run dev to start development server which will reload on every change to source code.

Use rye check --fix and rye fmt to lint and format code. Assumed to be run before each commit to guarantee code quality.

Use rye run basedpyright to ensure typing is correct.

📜 License

This project is licensed under the AGPLv3+ license - see the license file for details.