A sleek, real-time messaging app that lets you chat with friends instantly. Think of it as a super-fast, private chat room that you can spin up in seconds - perfect for quick conversations, sharing links, or just having fun with friends!
- Normal Mode: Clean, minimalist black interface
- Cosmic Mode: Beautiful starry background with glass-morphism effects
- Custom Name: Set your display name
- 12 Unique Colors: Pick your favorite color
- Avatar Shapes: Choose between square, circle, or diamond avatar
- Real-time updates - Messages appear instantly
- No glitches - Smooth animations and transitions
- No sign-up - Just share a link and start chatting
- One-click sharing with bore.pub
- No complicated setup - Works anywhere
- Private rooms - Each link creates a unique chat space
- Python 3.7+
- Rust & Cargo (for bore.pub - auto-installed if needed)
-
Get the code (save these files in a folder):
server.py(normal version)server_fancy.py(cosmic version)run.sh(launcher script)
-
Make it executable:
chmod +x run.sh
-
Run it:
./run.sh
-
Follow the prompts:
- Choose your version (normal or cosmic)
- Let it install everything automatically
- Share the link that appears!
- Run the script
- Choose your preferred version
- Get a public URL (e.g.,
https://abc123.bore.pub) - Share that URL with friends
- Click the link you shared
- Choose a name (optional)
- Start chatting!
- Change your name/color anytime by clicking your avatar
- Multiple rooms: Add
?room=yourroomnameto the URL for separate chats - Messages auto-save - won't disappear on refresh
- Works on mobile - responsive design looks great anywhere
- Backend: Python Flask server
- Frontend: Single HTML file with vanilla JavaScript
- Tunneling: bore.pub creates secure tunnels
- Storage: In-memory (resets on server restart)
cosmic-message-board/
โโโ server.py # Normal version (no stars)
โโโ server_fancy.py # Cosmic version (with stars)
โโโ run.sh # Launcher script
# Create virtual environment
python3 -m venv venv
source venv/bin/activate
# Install dependencies
pip install flask flask-cors
# Install bore.pub (for sharing)
cargo install bore-cli
# Run server
python server_fancy.py # or server.py
# In another terminal, create tunnel:
bore local 5000 --to bore.pubA: Messages are encrypted in transit via bore.pub's secure tunnel. However, anyone with the link can join the chat.
A: No, messages are stored in memory and disappear when the server stops. Perfect for temporary conversations!
A: Yes! The interface is fully responsive and works great on mobile browsers.
A: Technically unlimited, but performance is best with 2-20 people.
A: 100% free! No accounts, no payments, no tracking.
- Quick team huddles - Faster than setting up a Zoom
- Gaming sessions - Chat while playing games
- Event coordination - Share links and updates
- Study groups - Quick question/answer sessions
- Family chats - Share photos and messages
- Random fun - Just because!
- No installation - Works in any browser
- No accounts - No passwords to remember
- Instant setup - 30 seconds from zero to chatting
- Privacy - Your chat, your server
- Customization - Make it look how you want
- Messages don't persist after server restart
- No file sharing (text only)
- No user authentication (anyone with link can join)
- Limited to ~200 messages per room (oldest get deleted)
Want to improve it? Feel free to:
- Add new features
- Fix bugs
- Improve the design
- Add emoji support
- Create themes
Just edit the Python files - everything's in one place!
Having issues?
- Make sure Python 3.7+ is installed
- Check that Rust/cargo is installed (for bore.pub)
- Ensure no other app is using port 5000
- Try the normal version if cosmic has issues
# That's it! Just run:
./run.sh
# Share the link
# Start chatting
# Have fun! ๐Built for fun, used for connection. No ads, no tracking, just pure messaging.