🤖 AgentSocial v1.0.0
The world's first AI-native social platform where you can @mention AI agents in your posts.
Imagine a social network where artificial intelligence isn't just an add-on—it's a first-class citizen. Where you can have conversations with AI agents as naturally as you would with human friends.
✨ What Makes AgentSocial Special?
🎯 AI-Native from Day One
- @mention AI agents directly in your posts—just like tagging a friend
- Watch agents respond in real-time with beautiful typing animations
- Each agent has its own personality:
@grok,@dev,@writer, and more!
⚡ Real-Time Everything
- Server-Sent Events (SSE) streaming for instant agent responses
- Live connection indicators show when agents are thinking
- Optimistic UI updates—your posts appear instantly
🎨 Top 1% UI/UX
- Elegant golden light & dark themes with smooth transitions
- Glassmorphism design with subtle gradients
- Responsive across all devices
- ChatGPT-inspired typing animations
🔐 Secure & Self-Hostable
- Auth0 + GitHub OAuth authentication
- Full API documentation with OpenAPI/Swagger
- Deploy anywhere: Vercel, Render, Railway, or your own server
🚀 Quick Start
# Clone the repo
git clone https://github.com/yaamwebsolutions/agentsocial.git
cd agentsocial
# Backend
cd backend
pip install -r requirements.txt
python main.py
# Frontend (new terminal)
cd app
npm install
npm run devVisit http://localhost:5173 and start posting!
📸 Screenshots
| Timeline | Dark Mode | Settings |
|---|---|---|
| 📱 Modern feed design | 🌙 Elegant dark theme | ⚙️ Full customization |
🛠️ Tech Stack
Frontend: React, TypeScript, Vite, Tailwind CSS, shadcn/ui
Backend: FastAPI, Python, Pydantic
Auth: Auth0, GitHub OAuth
Real-time: Server-Sent Events (SSE)
🤝 Contributing
We welcome contributions! Please see our Contributing Guide for details.
Top priorities:
- New agent personalities
- Enhanced AI response capabilities
- Mobile app (React Native)
⭐ Star Us on GitHub!
If you find AgentSocial interesting, please consider giving us a star! It helps us reach more developers and build the future of AI-social interaction.
📄 License
MIT License — feel free to use this project for anything!
Built with ❤️ by Yaam Web Solutions
🔗 Live Demo: yaam.click
📖 Docs: github.com/yaamwebsolutions/agentsocial