Spaces:
Sleeping
Sleeping
| title: Global Chat Server | |
| emoji: 💬 | |
| colorFrom: gray | |
| colorTo: green | |
| sdk: docker | |
| app_port: 7860 | |
| pinned: false | |
| # Global Chat Server | |
| A WebSocket global chat server, multilingual profanity filter, and browser-based | |
| admin panel for Unity games. | |
| - Health check: `/health` | |
| - WebSocket: `/ws` | |
| - Translation: `POST /translate` | |
| - Language detection: `GET /locale` | |
| - Admin panel: `/` | |
| - Default admin password: `global-chat.1` | |
| - Message history: up to 100 messages per room, retained in memory for 24 hours | |
| - Presence: 4-second client heartbeat and 10-second offline timeout | |
| - Translation: device/browser language first, optional IP-country fallback | |
| - Language registry: 255 ISO/BCP-47 language and locale codes | |
| - Profanity moderation: 44,196 active dictionary entries across 74 languages, | |
| plus 430 curated English roots and 3,440 generated English forms (75 | |
| languages total) | |
| - Moderation privacy: local filtering only; chat messages are not sent to a | |
| third-party profanity API | |
| ## Translation secrets | |
| Free Translation mode tries five key-free Google translation URL templates in | |
| order. No API key is required. These endpoints are unofficial and may be | |
| rate-limited or changed by Google. Override the five templates with the | |
| `FREE_TRANSLATION_URLS` Space variable, separated by `|`, when necessary. | |
| API Translation mode supports these server-side Secrets: | |
| - Google Cloud: `GOOGLE_TRANSLATE_API_KEY` | |
| - Amazon Translate: `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_REGION` | |
| - OpenAI: `OPENAI_API_KEY` | |
| - Gemini: `GEMINI_API_KEY` | |
| - Azure Translator: `AZURE_TRANSLATOR_KEY`, `AZURE_TRANSLATOR_REGION` | |
| Never store production API keys in a Unity scene or player build. | |
| ## Free Hugging Face CPU Basic hardware | |
| At the time this package was prepared, Hugging Face documents CPU Basic as 2 | |
| vCPU, 16 GB RAM, and 50 GB of non-persistent Space disk at no charge. A free | |
| account also has a separate 100 GB private Hub storage allowance. Hub storage | |
| is not the Space runtime disk and this chat server does not persist messages to | |
| either one. Limits, sleep behavior, and pricing can change, so check the latest | |
| Hugging Face documentation before publishing a commercial product. | |
| ## Security | |
| Set an `ADMIN_PASSWORD` secret in the Space Settings before production. The | |
| default password is provided for first-time setup only. Public Space source | |
| code is visible to everyone, while values stored as Hugging Face Secrets are | |
| not displayed in the repository. | |