Skip to content

Commit daa4a27

Browse files
Ainura-DjumagulovAinura-Djumagulov
authored
Merge branch 'main' into compute-hpc-update-2
2 parents 44835df + c013d65 commit daa4a27

File tree

84 files changed

+31747
-1
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

84 files changed

+31747
-1
lines changed

‎ai/oracle-digital-assistant/oda-pro-styled/LICENSE

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
Copyright (c) 2025 Oracle and/or its affiliates.
2+
3+
The Universal Permissive License (UPL), Version 1.0
4+
5+
Subject to the condition set forth below, permission is hereby granted to any
6+
person obtaining a copy of this software, associated documentation and/or data
7+
(collectively the "Software"), free of charge and under any and all copyright
8+
rights in the Software, and any and all patent rights owned or freely
9+
licensable by each licensor hereunder covering either (i) the unmodified
10+
Software as contributed to or provided by such licensor, or (ii) the Larger
11+
Works (as defined below), to deal in both
12+
13+
(a) the Software, and
14+
(b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
15+
one is included with the Software (each a "Larger Work" to which the Software
16+
is contributed by such licensors),
17+
18+
without restriction, including without limitation the rights to copy, create
19+
derivative works of, display, perform, and distribute the Software and make,
20+
use, sell, offer for sale, import, export, have made, and have sold the
21+
Software and the Larger Work(s), and to sublicense the foregoing rights on
22+
either these or other terms.
23+
24+
This license is subject to the following condition:
25+
The above copyright notice and either this complete permission notice or at
26+
a minimum a reference to the UPL must be included in all copies or
27+
substantial portions of the Software.
28+
29+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
30+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
31+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
32+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
33+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
34+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
35+
SOFTWARE.

‎ai/oracle-digital-assistant/oda-pro-styled/README.md

Lines changed: 156 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,156 @@
1+
# ODA Pro Styled
2+
3+
🎥 **[View Demo Video](files/oda-pro-styled-demo.mp4)**
4+
5+
A complete solution for creating professional, customizable chat interfaces for Oracle Digital Assistant with enterprise-grade speech recognition capabilities.
6+
7+
## Overview
8+
9+
ODA Pro Styled provides everything you need to deploy branded chat experiences that integrate seamlessly with Oracle Digital Assistant. Perfect for solution architects, sales teams, and developers who need to quickly showcase Oracle Digital Assistant across multiple client scenarios.
10+
11+
**What's Included:**
12+
13+
- **Frontend**: Modern React chat interface with multi-project theming
14+
- **Backend**: Oracle AI Speech Service integration for enhanced speech recognition
15+
16+
## Key Features
17+
18+
**🎨 Professional Showcase Capabilities**
19+
20+
- Multi-project management (up to 8 branded configurations)
21+
- Instant theme switching for client demonstrations
22+
- Custom branding with logos, colors, and backgrounds
23+
- Lightning-fast project setup (under 30 seconds)
24+
25+
**🎤 Enterprise Speech Integration**
26+
27+
- Dual speech options: Browser native or Oracle AI Speech Service
28+
- **Multilingual Support**: 50+ languages including Spanish, French, German, Chinese, Japanese, Arabic, and more
29+
- Real-time speech-to-text with enterprise-grade accuracy
30+
- Automatic text-to-speech using Oracle Digital Assistant's TTS
31+
- Seamless voice conversation flow
32+
33+
**💬 Rich Chat Experience**
34+
35+
- Full markdown support for formatted responses
36+
- File attachment support (images and PDFs)
37+
- Real-time WebSocket communication
38+
- Responsive design across all devices
39+
40+
**🔒 Privacy & Security**
41+
42+
- Client data stored locally (localStorage)
43+
- No server dependencies for configuration data
44+
- Secure Oracle Cloud authentication
45+
- Complete client data isolation
46+
47+
## Architecture
48+
49+
The solution consists of two complementary components:
50+
51+
### Frontend (React/Next.js)
52+
53+
- Multi-tenant chat interface
54+
- Dynamic theming system
55+
- Oracle Digital Assistant WebSDK integration
56+
- Speech recognition interface
57+
58+
### Backend (Node.js/Express)
59+
60+
- Oracle AI Speech Service WebSocket proxy
61+
- **Multilingual speech recognition** (50+ languages via Whisper technology)
62+
- Real-time audio processing pipeline
63+
- FFmpeg audio format conversion
64+
- Secure Oracle Cloud authentication
65+
66+
## Quick Start
67+
68+
### Option 1: Frontend Only
69+
70+
Basic setup with browser speech recognition:
71+
72+
```bash
73+
cd files/frontend/
74+
npm install
75+
cp .env.example .env.local
76+
# Configure your Oracle Digital Assistant credentials
77+
npm run dev
78+
```
79+
80+
### Option 2: Full Stack (Recommended)
81+
82+
Complete setup with Oracle AI Speech Service:
83+
84+
```bash
85+
# Start backend
86+
cd files/backend/
87+
npm install
88+
cp .env.example .env
89+
# Configure Oracle Cloud credentials
90+
npm start
91+
92+
# Start frontend (in new terminal)
93+
cd files/frontend/
94+
npm install
95+
cp .env.example .env.local
96+
# Configure Oracle Digital Assistant + Speech Service URL
97+
npm run dev
98+
```
99+
100+
## Configuration
101+
102+
### Oracle Digital Assistant Setup
103+
104+
1. Create a Web channel in your Oracle Digital Assistant
105+
2. Note the Channel ID and URI
106+
3. Configure in frontend `.env.local`
107+
108+
### Oracle AI Speech Service Setup (Optional)
109+
110+
1. Enable AI Speech Service in Oracle Cloud Infrastructure
111+
2. Generate API credentials
112+
3. Configure in backend `.env`
113+
114+
Detailed setup instructions are available in each component's README.
115+
116+
## Use Cases
117+
118+
**Sales Demonstrations**
119+
120+
- Quickly switch between different client brand themes
121+
- Showcase Oracle Digital Assistant capabilities
122+
- Professional presentation-ready interface
123+
124+
**Development & Testing**
125+
126+
- Rapid prototyping with multiple configurations
127+
- A/B testing different chat experiences
128+
- Integration testing with Oracle services
129+
130+
**Production Deployments**
131+
132+
- Enterprise-ready speech recognition
133+
- Scalable WebSocket architecture
134+
- Secure credential management
135+
136+
## Components
137+
138+
- **Frontend**: [`files/frontend/`](files/frontend/) - Complete React chat interface
139+
- **Backend**: [`files/backend/`](files/backend/) - Oracle AI Speech Service integration
140+
141+
## Technology Stack
142+
143+
**Frontend**: Next.js 15, React 19, Material-UI, Framer Motion, Oracle WebSDK
144+
**Backend**: Node.js, Express, WebSocket, Oracle AI Speech SDK, FFmpeg
145+
146+
## Browser Requirements
147+
148+
- Modern browser with WebSocket support
149+
- Web Speech API (for browser speech mode)
150+
- LocalStorage for project persistence
151+
152+
## License
153+
154+
Copyright (c) 2025 Oracle and/or its affiliates.
155+
156+
Licensed under the Universal Permissive License v1.0.

‎ai/oracle-digital-assistant/oda-pro-styled/files/backend/LICENSE

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
Copyright (c) 2025 Oracle and/or its affiliates.
2+
3+
The Universal Permissive License (UPL), Version 1.0
4+
5+
Subject to the condition set forth below, permission is hereby granted to any
6+
person obtaining a copy of this software, associated documentation and/or data
7+
(collectively the "Software"), free of charge and under any and all copyright
8+
rights in the Software, and any and all patent rights owned or freely
9+
licensable by each licensor hereunder covering either (i) the unmodified
10+
Software as contributed to or provided by such licensor, or (ii) the Larger
11+
Works (as defined below), to deal in both
12+
13+
(a) the Software, and
14+
(b) any piece of software and/or hardware listed in the lrgrwrks.txt file if
15+
one is included with the Software (each a "Larger Work" to which the Software
16+
is contributed by such licensors),
17+
18+
without restriction, including without limitation the rights to copy, create
19+
derivative works of, display, perform, and distribute the Software and make,
20+
use, sell, offer for sale, import, export, have made, and have sold the
21+
Software and the Larger Work(s), and to sublicense the foregoing rights on
22+
either these or other terms.
23+
24+
This license is subject to the following condition:
25+
The above copyright notice and either this complete permission notice or at
26+
a minimum a reference to the UPL must be included in all copies or
27+
substantial portions of the Software.
28+
29+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
30+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
31+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
32+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
33+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
34+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
35+
SOFTWARE.

0 commit comments

Comments
 (0)