Installation on your own infrastructure
Singularities AI runs all LLMs on your own infrastructure, ensuring data privacy and security.
Singularities AI is a feature-rich web platform for interacting with Ollama-powered text-based AI models. It is designed for both beginners and professionals, offering customization, role management, and a responsive interface.
Get the Source Code
Singularities AI is open source and available on GitHub. To get started, clone the repository:
git clone https://github.com/Singularities-AI/singularities-ai.git
cd singularities-ai
Prerequisites
- Ollama installed and running
- Java 21 (for the Spring Boot API)
- Node.js ≥ 20 (for the frontend)
- pnpm ≥ 8 (for package management)
- PostgreSQL ≥ 16 (for data persistence)
Installation
1. Set Up PostgreSQL
Install and start PostgreSQL. Create a new database and user for Singularities AI:
sudo -u postgres psql -c "CREATE DATABASE singularities;"
sudo -u postgres psql -c "CREATE USER singularities WITH PASSWORD 'yourpassword';"
sudo -u postgres psql -c "GRANT ALL PRIVILEGES ON DATABASE singularities TO singularities;"
2. Configure and Run the API
Clone the repository and navigate to the backend directory. Update the following properties in application.properties:
| Property | Example Value | Description |
|---|---|---|
singularities.app.jwtSecret | your_jwt_secret | JWT secret for authentication |
spring.mail.host | smtp.example.com | SMTP host for email |
spring.mail.username | user@example.com | SMTP username |
spring.mail.password | yourpassword | SMTP password |
app.name | Singularities AI | Your app name |
app.url | http://localhost:8080 | API base URL |
app.url.client | http://localhost:7000 | Frontend URL |
spring.ai.ollama.base-url | http://localhost:11434 | Ollama server URL |
spring.datasource.url | jdbc:postgresql://localhost:5432/singularities | PostgreSQL connection URL |
spring.datasource.username | singularities | PostgreSQL username |
spring.datasource.password | yourpassword | PostgreSQL password |
Start the API:
mvn spring-boot:run
3. Configure and Run the Frontend
Navigate to the frontend directory. Update the .env file:
API_URL=http://localhost:8080
Install dependencies and start the frontend:
pnpm install
pnpm dev
http://localhost:7000.Configuration
API Configuration
You can customize the API behavior by editing application.properties. For example, to change the server port:
server.port=8080
Frontend Configuration
Update the .env file to match your API URL and other environment variables as needed.
Support
For questions, suggestions, or assistance, open an issue or contact contact@singularities-ai.com.