A CLI social media app where likes are coins.

• Modern Terminal UI: TUI built with Textual
• Posting Images: Post images from your terminal
• Coins: Likes are represented as coins
• Cross-Platform: Works on Linux, macOS, and Windows
• Security: Hashing of passwords and usage of auth tokens to avoid storing the password

• Python 3.9 or higher
• Modern terminal (iTerm2, Kitty, or similar recommended for best image support)

pip install celar

celar

You can also run:

python -m celar

On launch, you'll be prompted to set the server URL There is a hosted instance at https://celar.simon.hackclub.app in demo mode (registration disabled) but you can also run your own server (see server docs). Login as the user demo with password demo.

• Server Documentation: Complete API reference, authentication, and deployment
• Client Documentation: Installation, usage, and troubleshooting

• Textual: Amazing Python TUI framework
• FastAPI: Modern, fast web framework

This project is licensed under the GNU General Public License v3.0 - see the LICENSE files for details.