A nitter-like frontend for instagram
- Lua 62.7%
- HTML 19.5%
- CSS 13.3%
- Dockerfile 1.4%
- YAML 1.2%
- Other 1.9%
Irelephant
a1de10e43a
All checks were successful
Build and Push Docker Image / build (push) Successful in 3m16s
Reviewed-on: #54 |
||
|---|---|---|
| .forgejo/workflows | ||
| conf | ||
| docs/assets | ||
| lib | ||
| models | ||
| static | ||
| views | ||
| .dockerignore | ||
| .editorconfig | ||
| .gitattributes | ||
| .gitignore | ||
| app.lua | ||
| CLAUDE.md | ||
| config.example.lua | ||
| docker-compose.yml | ||
| Dockerfile | ||
| instances.json | ||
| kittygram-dev-1.rockspec | ||
| LICENSE | ||
| migrations.lua | ||
| mime.types | ||
| models.lua | ||
| nginx.example.conf | ||
| README.md | ||
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.
Table of contents
Why Kittygram?
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
| Instance link: | Operated by: | Notes: |
|---|---|---|
| kittygram.irelephant.net | Irelephant | Creator of Kittygram. |
| kittygr.am | FSKY | |
| kittygram.kareem.one | Kareem | Cloudflare. |
| kittygram.nexussfan.cz | NexusSfan | |
| kg.lus.lu | ffb0f3 | |
| kg.meowing.de | patrick |
Also see /instances.json file.
Installation
✨ Method 1: Docker (Recommend!)
git clone https://codeberg.org/irelephant/kittygram.git
cd kittygram
git lfs pull
- Start the container.
sudo docker compose up
Method 2: Running from scratch
- Install openresty, redis or valkey, luarocks (likely in your distro's package manager) and git-lfs.
- Clone, move to Kittygram folder and setup LFS.
git clone https://codeberg.org/irelephant/kittygram.git
cd kittygram
git lfs pull
- Copy the example configuration files:
cp nginx.example.conf nginx.conf
cp config.example.lua config.lua
- Run:
luarocks init --lua-version=5.1 --lua-versions=5.1
CC="gcc -std=gnu99" luarocks build
lapis migrate
# Run the project
lapis serve production
Info
License
Kittygram is licensed under the AGPL-3.0.
Community
Feel free to join the Matrix room, or email me at [email protected].
- Icon made by nulla.
- README design made by Ivan Kopylov.
⭐ If you like this project, please consider giving it a star!