1
0
mirror of https://codeberg.org/irelephant/kittygram.git synced 2026-01-14 03:38:05 +01:00
2025-12-17 22:00:49 +00:00
2025-12-16 04:26:00 +01:00
2025-12-17 22:00:49 +00:00
2025-12-17 22:00:49 +00:00
2025-08-13 22:05:10 +01:00
2025-08-13 22:05:10 +01:00

Kittygram

Kittygram is an anonymous, privacy-friendly, lightweight, and open-source Instagram frontend inspired by nitter . It offers a clean, fast way to browse Instagram without the usual clutter or tracking.

Why

The official Instagram web interface is heavy on JavaScript, slow to load, and filled with pop-ups. Kittygram avoids all of that by serving fully prerendered pages, making it faster and easier to use.

Kittygram also helps you avoid the heavy tracking instagram does, as all requests are handled by kittygram.

Limitations

  • As of now, only the first ~20 comments on a post can be fetched.
  • Instagram aggresively rate-limits requests coming from servers, which can make running a public instance difficult.

Instances

URL Description
https://kittygr.am An instance of kittygram operated by FSKY
https://kittygram.irelephant.net An instance of kittygram run by its creator

Installation

Note

I highly recommend you install kittygram using docker. Luarocks can be finicky a lot of the time.

Method 1: Docker

  1. Install docker.
  2. Clone the project:
git clone https://codeberg.org/irelephant/kittygram.git
  1. Move to the projects directory:
cd kittygram
  1. Start the container
sudo docker compose up

Method 2: Running from scratch

  1. Clone the project:
git clone https://codeberg.org/irelephant/kittygram.git
  1. Install openresty
  2. Install redis or valkey
  3. Install luarocks (likely in your distro's package manager), and install the project's dependencies:
# Try running CC="gcc -std=gnu99" if you get some compilation errors. 
sudo luarocks install lapis
sudo luarocks install lua-resty-http
sudo luarocks install htmlparser
sudo luarocks install lua-cjson
sudo luarocks install lua-resty-openssl
sudo luarocks install lsqlite3
sudo luarocks install lua-resty-redis
sudo luarocks install lapis-redis
  1. Run lapis migrate
  2. Run lapis serve production to run the project.

Note

You may have more luck installing modules locally. That is detailed here: https://github.com/leafo/lapis/issues/777#issuecomment-1900359264


Kittygram is licensed under the AGPL-3.0.

Icon made by nulla.

Description
A nitter-like frontend for instagram
Readme AGPL-3.0 254 KiB
Languages
Lua 80.5%
CSS 16.5%
Dockerfile 3%