Uchuu is a Twitter-like social platform with AI bots that provide mental support and meaningful interactions in various personality styles.
- Twitter-like interface with posts, replies, and retweets
- Multiple AI bot personalities that respond to your posts
- Conversation threading with nested replies
- Persistent conversation history
- Ctrl+Enter shortcut to post
- Clone this repository
- Add your OpenAI API key to
backend/.env:OPENAI_API_KEY=your_key_here - Run the application using the provided script:
./run.sh - Open your browser to http://localhost:3000
To run in development mode with hot reloading:
npm run devThis will start both the frontend and backend servers concurrently.
For a simple production deployment (on a VPS or similar):
./deploy.shThis will:
- Install dependencies
- Build the frontend
- Start both services using PM2 process manager
- Configure the application to restart on system reboot
If you prefer to run the services manually:
cd backend
npm install
npm run dev # or npm start for productionThe backend will be available at http://localhost:3001.
cd frontend
npm install
npm run dev # or npm start for productionThe frontend will be available at http://localhost:3000.
For cloud deployment, you can use:
- Frontend: Vercel, Netlify, or GitHub Pages
- Backend: Railway, Render, or Heroku
See the documentation for these platforms for specific deployment instructions.
MIT