101 lines
2.4 KiB
Markdown
101 lines
2.4 KiB
Markdown
# Aethera
|
|
|
|
A sophisticated web dashboard for AI-powered conversations and image generation with chat interface, multiple conversations, and local storage capabilities.
|
|
|
|
## Features
|
|
|
|
- **Chat Interface**: Engage with AI models through a clean, responsive chat interface
|
|
- **Multiple Conversations**: Switch between different conversation threads
|
|
- **Image Generation**: Create and manage AI-generated images with customizable prompts
|
|
- **Theme Support**: Toggle between light and dark modes
|
|
- **Local Storage**: All conversations and images are stored locally on your system
|
|
- **Markdown Rendering**: View beautifully formatted responses with syntax highlighting
|
|
|
|
## Quick Start
|
|
|
|
### Prerequisites
|
|
|
|
- Go 1.25.5 or later
|
|
- Bun package manager
|
|
- An OpenAI-compatible API endpoint (OpenAI, local LLM, etc.)
|
|
|
|
### Installation
|
|
|
|
1. Clone the repository:
|
|
|
|
```bash
|
|
git clone <repository-url>
|
|
cd aethera
|
|
```
|
|
|
|
2. Build the backend:
|
|
|
|
```bash
|
|
cd backend
|
|
go build -o ./dist/aethera ./cmd
|
|
```
|
|
|
|
3. Build the frontend:
|
|
|
|
```bash
|
|
cd ../frontend
|
|
bun run build
|
|
```
|
|
|
|
### Running the Application
|
|
|
|
Start the server from the backend directory:
|
|
|
|
```bash
|
|
./dist/aethera
|
|
```
|
|
|
|
By default, the application runs at `http://localhost:8080`
|
|
|
|
Open your browser and navigate to the URL to begin using Aethera.
|
|
|
|
## Configuration Options
|
|
|
|
You can customize the server behavior with these command-line flags:
|
|
|
|
- `--data-dir`: Directory for storing generated images (default: `data`)
|
|
- `--listen`: Address to listen on (default: `localhost`)
|
|
- `--port`: Port to listen on (default: `8080`)
|
|
|
|
Example:
|
|
|
|
```bash
|
|
./dist/aethera --port 3000 --listen 0.0.0.0
|
|
```
|
|
|
|
## Getting Started
|
|
|
|
1. **Configure Your API**: Navigate to the Settings page and enter your OpenAI-compatible API endpoint URL
|
|
2. **Start Chatting**: Use the Chat interface to begin conversations with your AI model
|
|
3. **Generate Images**: Visit the Images page to create images using text prompts
|
|
4. **Manage Your Content**: View and delete images, organize conversations
|
|
|
|
## Supported AI Services
|
|
|
|
Aethera works with any OpenAI-compatible API, including:
|
|
|
|
- OpenAI
|
|
- Local LLMs (Ollama, LocalAI, etc.)
|
|
- Other compatible AI services
|
|
|
|
Configure your preferred service in the Settings page.
|
|
|
|
## Troubleshooting
|
|
|
|
### API Connection Issues
|
|
|
|
If you see authentication errors, verify your API endpoint URL is correct and accessible.
|
|
|
|
### Port Already in Use
|
|
|
|
Change the port using the `--port` flag if port 8080 is unavailable.
|
|
|
|
## License
|
|
|
|
See LICENSE file for details.
|