A scalable platform for creating and managing AI-powered social interaction agents with adaptive communication capabilities.
- 📝 Project Overview
- 🚀 Key Features
- 🏗️ Technical Architecture
- 🔧 Development Setup
- ⚙ Configuration
- 📁 File Structure
- 📜 License
Siren-Net enables users to:
- Create personalized AI agents with configurable personalities
- Manage complex social interaction workflows
- Generate dynamic content based on contextual analysis
- Prioritize engagement using interaction metrics
- Deploy AI agents across multiple communication channels
- Context-aware conversation patterns
- Memory retention system for relationship building
- Multi-modal response generation (text + images)
- Web-based dashboard for agent configuration
- Real-time interaction monitoring
- Batch operations for agent groups
- Interaction frequency scoring
- Relationship depth analysis
- Dynamic attention allocation
- Priority queue management
- Contextual image creation API
- Style transfer capabilities
- Template-based content workflows
- Multi-model inference support
- JWT-based authentication
- Role-based access control
- Request validation middleware
- Encrypted communication channels
- Gin web framework with custom middleware
- Layered architecture (handlers ↔ services ↔ repositories)
- GORM with SQLite for data persistence
- React 18+ with functional components
- Shadcn UI component library
| Service | Technology | Functionality |
|---|---|---|
| Conversation Engine | Ollama (DeepSeek) | NLP processing, dialog management |
| Image Generation | Stable Diffusion | Context-aware image synthesis |
| Priority Engine | Custom Go | Interaction scoring algorithms |
- Go 1.21+
- Node 18+
- Docker 24+
- NVIDIA GPU (recommended)
# Clone repository
git clone https://github.com/yourusername/siren-net.git
# Start services
docker-compose up -d --build
# Access endpoints
http://localhost:5173 # Frontend
http://localhost:8080 # Backend API
http://localhost:11434 # Ollama
http://localhost:7860 # Stable Diffusion- Copy backend/.env.example to backend/.env
- Set required values:
# JWT Configuration
JWT_SECRET = your_secure_secret
DATABASE_URL = your_url_to_sqlite_databasesiren-net/
├── backend/
│ ├── cmd/
│ │ └── web/
│ │ └── main.go
│ ├── internal/
│ │ ├── app/
│ │ │ ├── app.go
│ │ ├── config/
│ │ │ ├── config.go
│ │ ├── handlers/
│ │ │ ├── auth_handler.go
│ │ │ ├── auth_handler_test.go
│ │ ├── middleware/
│ │ │ ├── auth_middleware.go
│ │ ├── models/
│ │ │ ├── agent.go
│ │ │ ├── client.go
│ │ │ ├── message.go
│ │ │ ├── transaction.go
│ │ │ ├── user.go
│ │ ├── routes/
│ │ │ ├── routes.go
│ │ ├── services/
│ │ │ ├── auth_service.go
│ │ │ ├── errors.go
│ │ │ ├── user_service.go
│ │ └── utils/
│ │ ├── password.go
│ ├── pkg/
│ │ └── database/
│ │ ├── database.go
│ ├── tests/
│ │ └── integration/
│ │ ├── auth_test.go
│ ├── go.mod
│ ├── go.sum
│ ├── .env
│ ├── .env.example
│ └── Dockerfile
├── frontend/
│ └── ...
├── stable-diffusion/
│ ├── models/ -- stable diffusion models and loras
│ ├── outputs/ -- stable diffusion outputs
│ └── Dockerfile
├── ollama/
│ ├── models/ -- deepseek models
│ ├── Dockerfile
│ ├── Modelfile
│ └── start.sh
├── .gitignore
├── .gitmodules
├── docker-compose.yml
├── LICENSE
└── README.md
MIT License - See LICENSE for details