Skip to content

Commit 093b980

Browse files
authored
doc: readme and license
1 parent ee66aa0 commit 093b980

File tree

2 files changed

+118
-0
lines changed

2 files changed

+118
-0
lines changed

README.md

Lines changed: 99 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,99 @@
1+
2+
<center>
3+
<img style="width:65px;" src="https://i.ibb.co/08rtXCB/logo.png" alt="logo" border="0">
4+
5+
# Singularities AI - Ollama Web UI
6+
</center>
7+
8+
Singularities AI is a web platform designed to leverage text-based AI models powered by Ollama. Feature-rich, it has been built to deliver a simple yet high-performance experience, even for users new to LLMs. With its customization options, role configuration, and access management, Singularities AI is an ideal solution for professional use, ensuring data security and eliminating reliance on proprietary APIs.
9+
10+
**Need an enterprise plan or custom features?****[Contact us](mailto:contact@singularities-ai.com)**
11+
12+
## Installation 🚀
13+
14+
### Ollama
15+
You need to have Ollama installed on a machine with a URL accessible by the API.
16+
17+
Please follow the [Ollama documentation](https://github.com/ollama/ollama) for installation instructions.
18+
19+
### Running the API
20+
21+
You need to configure the following properties:
22+
23+
- `singularities.app.jwtSecret` = Your JWT secret (e.g., generated with a JWT secret generator)
24+
- `spring.mail.host` = Your SMTP provider host
25+
- `spring.mail.username` = Your SMTP provider username
26+
- `spring.mail.password` = Your SMTP provider password
27+
- `app.name` = Your app name (e.g., Singularities AI)
28+
- `app.url` = Your frontend URL (e.g., http://127.0.0.1:7000)
29+
- `app.url.client` = Client URL (e.g., http://127.0.0.1:7000)
30+
- `spring.ai.ollama.base-url` = Your Ollama server URL (e.g., http://localhost:11434)
31+
32+
Then, start the application using Maven:
33+
34+
```bash
35+
mvn spring-boot:run
36+
````
37+
38+
### Running the Frontend
39+
40+
1. Update the `.env` file:
41+
42+
```env
43+
API_URL=Your API URL (e.g., http://localhost:8080)
44+
```
45+
46+
2. Install dependencies:
47+
48+
```bash
49+
pnpm install
50+
```
51+
52+
3. Start the application using the scripts available in `package.json`.
53+
54+
&nbsp;
55+
56+
>
57+
> The `:dev` branch contains the latest unstable features and changes. Use it at your own risk as it may have bugs or incomplete features.
58+
59+
## Features ⚡️
60+
61+
- **Secure and Local-First**: All LLMs are stored and run on your machine without any external internet interaction. This ensures that no data can be leaked.
62+
63+
- **Multi-Model Conversations**: Singularities supports multiple LLMs and allows you to switch between them within the same conversation with just a few clicks.
64+
65+
- **Chat and User Context**: You can define a custom context for a single conversation or across all your conversations to personalize your interactions with the LLMs.
66+
67+
- **Responsive Design**: The application works seamlessly on PC, tablet, or mobile, regardless of screen size.
68+
69+
- **Easy Customization**: The public source code allows anyone to modify, remove, or add new features according to their needs.
70+
71+
- **Continuous Updates**: Singularities AI is actively developed, with new features being added regularly.
72+
73+
74+
## ⚙️ Built with
75+
76+
[![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=fff)](#)
77+
[![Nuxt](https://img.shields.io/badge/Nuxt-002E3B?logo=nuxt&logoColor=#00DC82)](#)
78+
[![shadcn/ui](https://img.shields.io/badge/shadcn%2Fui-000?logo=shadcnui&logoColor=fff)](#)
79+
[![Java](https://img.shields.io/badge/Java-%23ED8B00.svg?logo=openjdk&logoColor=white)](#)
80+
[![Spring Boot](https://img.shields.io/badge/Spring%20Boot-6DB33F?logo=springboot&logoColor=fff)](#)
81+
[![Postgres](https://img.shields.io/badge/Postgres-%23316192.svg?logo=postgresql&logoColor=white)](#)
82+
[![Ollama](https://img.shields.io/badge/Ollama-fff?logo=ollama&logoColor=000)](#)
83+
84+
## Screenshot 📷
85+
<img src="https://i.ibb.co/v4rVTLcJ/image.png" alt="Login page" border="0">
86+
<img src="https://i.ibb.co/8gfx4wpp/image.png" alt="Chat page" border="0">
87+
<img src="https://i.ibb.co/Z1crttjh/image.png" alt="Account page" border="0">
88+
<img src="https://i.ibb.co/35nwG9WF/image.png" alt="Admin models page" border="0">
89+
90+
## License 📜
91+
92+
This project is licensed under a Source-Available Non-Commercial License.
93+
Free for personal, educational, or non-commercial use.
94+
The free version is provided “as-is” without warranty; commercial licenses may include warranties.
95+
For full license text, see LICENSE.txt.
96+
97+
## Support 💬
98+
99+
If you have any questions, suggestions, or need assistance, please open an issue or contact us at contact@singularities-ai.com

frontend/LICENSE.txt

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
Copyright (c) 2025 Singularities AI
2+
3+
Source-Available Non-Commercial License
4+
5+
You may:
6+
- Download, use, and modify this software for personal, educational, or non-commercial purposes.
7+
8+
You may not:
9+
- Sell, redistribute, or use this software for commercial purposes without obtaining a commercial license from the copyright holder.
10+
- Companies with more than 50 users must acquire a commercial license to use this software.
11+
12+
Warranty:
13+
- The free version (personal/non-commercial use) is provided "as-is", without any warranty.
14+
- The commercial version (enterprise license) may include specific warranties as defined in the commercial agreement.
15+
16+
Distribution:
17+
- Any redistribution, modified or unmodified, must retain this license text.
18+
19+
By using this software, you agree to comply with the terms of this license.

0 commit comments

Comments
 (0)