Metadata-Version: 2.4
Name: veilchat
Version: 0.2.3
Summary: Privacy-first terminal social network and chat
Author: Razie1
License: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: click>=8.0.0
Requires-Dist: requests>=2.31.0
Requires-Dist: bcrypt>=4.0.0
Provides-Extra: tor
Requires-Dist: PySocks>=1.7.0; extra == "tor"

# 🕶️ Veilchat

> Chat beyond the surface.

Privacy-first terminal social network and chat platform.

## Install

```bash
pip install veilchat
```

## 💬 Chat Rooms (vc / veilchat)

```bash
vc search                    # List all chat rooms
vc search raziechat          # Find a specific room
vc open --name raziechat     # Open your own room
vc enter raziechat           # Enter a room
vc enter 192.168.1.100 --direct  # Direct IP connection
```

## 📱 Social (vt / veiltalk)

```bash
vt register                  # Create account
vt login                     # Log in
vt logout                    # Log out
vt whoami                    # Who am I?

vt post "Hello Veilchat!"    # Create a post
vt feed                      # Global feed
vt feed -f                   # Following feed
vt feed --hashtag rust       # Filter by hashtag
vt feed --user alice         # User's posts

vt follow @alice             # Follow a user
vt unfollow @alice           # Unfollow
vt followers                 # Your followers
vt following                 # Who you follow

vt like 1                    # Like a post
vt reply 1 "Nice post!"      # Reply to a post
vt repost 1                  # Share a post
vt thread 1                  # View post + replies

vt profile                   # Your profile
vt profile @alice            # View someone's profile
vt bio --bio "Developer"     # Update bio
vt bio --location "NYC"      # Update location
vt bio --website "https://yoursite.com"

vt search "rust"             # Search posts
vt trending                  # Trending hashtags
```

## 🔒 Privacy

- bcrypt password hashing with automatic salting
- SQL injection protected throughout
- Tor support: `torsocks vc enter raziechat`
- Data stored locally in `~/.veilchat/`

## 🌐 Making a Server Public

By default, a chat room is only reachable by clients on the same local network
(LAN). To make it reachable from anywhere, use a tunnel and tell the server to
advertise the tunnel's address instead of its LAN IP.

### Tailscale Funnel (recommended)

Funnel gives you a stable public hostname. Clients do **not** need Tailscale
installed — they just connect to the room name.

# One-time setup
tailscale up
tailscale funnel 5555        # expose local port 5555 publicly

# Start the room, advertising the Funnel hostname
vc open --name raziechat \
    --public-host your-machine.tail1234.ts.net \
    --public-port 443

## 🌐 Registry

Chat rooms discovered via `https://veil.pythonanywhere.com`

## License

MIT — Made by Razie1
