Solesonic LLM UI

A React-based user interface for the Solesonic LLM chat application. This project provides a modern, responsive web interface for interacting with the Solesonic LLM API.

Features

• Chat interface for interacting with Solesonic LLM
• User authentication via AWS Cognito
• Document upload and management
• Integration with Atlassian services
• Responsive design for desktop and mobile

Getting Started

Prerequisites

• Node.js (LTS version recommended)
• npm or yarn
• Access to AWS Cognito for authentication (or use mock mode)

Installation

1. Clone the repository:

   git clone <repository-url>
   cd solesonic-llm-ui

2. Install dependencies:

   npm install

3. Configure environment variables:

   cp .env.example .env

   Edit the .env file to set your own values for:

   • AWS Cognito User Pool IDs
   • AWS Cognito Client IDs
   • AWS Cognito Domain
   • API and UI base URIs

   For development, you can use mock mode by setting:

   VITE_MOCK_AMPLIFY=true
   VITE_MOCK_API=true
   

4. Start the development server:

   npm run dev

5. Open your browser and navigate to http://localhost:3000

Production Deployment

For production deployment using Docker and Nginx, see README.docker.md.

Project Structure

• src/ - Source code
  • chat/ - Chat interface components
  • service/ - Service layer for API communication
  • client/ - HTTP client configuration
  • properties/ - Application configuration
  • util/ - Utility functions

Security Considerations

• Never commit your .env file to version control
• Use environment-specific variables for different deployment environments
• Keep AWS Cognito credentials secure
• Use HTTPS in production environments

Example Usage

Jira Integration Showcase

The following example demonstrates how the Solesonic LLM API can automatically create Jira issues based on natural language requests:

User Prompt:

Resulting Jira Issue:

In this example:

1. The user describes a need to deploy an MCP server using natural language
2. The system automatically detects the CREATING_JIRA_ISSUE intent
3. It creates a properly formatted Jira issue (IB-34) with:
   • User story format following best practices
   • Detailed description and acceptance criteria
   • Proper assignment to the specified user (Isaac)
   • Direct link to the created issue

This showcases the power of intent-based prompting and seamless Atlassian integration without requiring users to know specific Jira API calls or formatting.

License

This project is licensed under the Apache License, Version 2.0 - see the LICENSE file for details.

Copyright 2025 Solesonic

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

For more information about the Apache License, Version 2.0, please visit: https://www.apache.org/licenses/LICENSE-2.0