EyuXBeta - GitLite

KO | EN

gitlite — search

#go #cross-platform #pdf #css #awesome #security #nodejs #computer-vision #markdown #csharp

EyuXBeta

(★ 26)

A sleek AI-powered chat app with dynamic personalities, image generation, web search, and voice. Built with React Native & Expo. Web: https://eyux.com.et | Android: https://eyux.en.uptodown.com/android Desktop app: https://apps.microsoft.com/detail/9NX5DBW6NHW1?hl=en-us&gl=US&ocid=pdpshare

File Explorer

ZIP Download

- FUNDING.yml
- settings.json
- - index.tsx
- - SpaceMono-Regular.ttf
- - 1.png
  - 11.png
  - 2.png
  - 22.png
  - 3.png
  - 333.png
  - 4.png
  - 5.png
  - 6.png
  - 9.png
  - adaptive-icon.png
  - eyux.gif
  - favicon.png
  - favicon2.png
  - icon.png
  - mobile_charts.png
  - mobile_polls.png
  - mobile_search.png
  - notification-icon.png
  - partial-react-logo.png
  - python_preview.png
  - react-logo.png
  - [email protected]
  - [email protected]
  - splash-icon (1).ico
  - splash-icon.png
- - IconSymbol.ios.tsx
  - IconSymbol.tsx
  - TabBarBackground.ios.tsx
  - TabBarBackground.tsx
- Collapsible.tsx
- ExternalLink.tsx
- HapticTab.tsx
- HelloWave.tsx
- ParallaxScrollView.tsx
- ThemedText.tsx
- ThemedView.tsx
- Colors.ts
- useColorScheme.ts
- useColorScheme.web.ts
- useThemeColor.ts
- reset-project.js
- - geminiService.ts
  - tavilyService.ts
- - AgenticIDE.tsx
  - DrawingCanvasModal.tsx
  - FlashcardGenerator.tsx
  - FlashcardViewer.tsx
  - MermaidViewer.tsx
  - SideImageViewer.tsx
  - TrialBanner.tsx
- - api.ts
  - app.ts
  - flashcard.ts
  - personalities.ts
  - storage.ts
- - ToastContext.tsx
- - useNavigationBarStyler.ts
  - usePrevious.ts
- - ApiKeySetupScreen.tsx
  - ChatScreen.tsx
  - OnboardingScreen.tsx
  - SettingsNavigator.tsx
- - fileService.ts
  - notificationService.ts
  - storageService.ts
- - index.ts
- - systemInstructions.ts
  - TrialBanner.tsx
  - webNotifications.ts
- App.tsx
.gitignore
app.json
eas.json
eslint.config.js
favicon.png
package-lock.json
package.json
README.md
tsconfig.json

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center">
<img src="https://raw.githubusercontent.com/Eul45/EyuXBeta/main/assets/images/favicon2.png" alt="EyuX Logo" width="150"/>

<br/><br/>
  <strong>A feature-rich, multi-personality AI chat and productivity app built with React Native & Expo.</strong>
  <br/><br/>
  <a href="https://github.com/Eul45/EyuX/stargazers"><img src="https://img.shields.io/github/stars/Eul45/EyuX?style=for-the-badge&logo=github&color=c471ed&logoColor=white" alt="Stars"/></a>
  <a href="https://github.com/Eul45/EyuX/network/members"><img src="https://img.shields.io/github/forks/Eul45/EyuX?style=for-the-badge&logo=github&color=5ac8fa&logoColor=white" alt="Forks"/></a>
  <a href="https://github.com/Eul45/EyuX/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Eul45/EyuX?style=for-the-badge&color=34c759" alt="License"/></a>
</div>

---
<div align="center">
  <img src="https://raw.githubusercontent.com/Eul45/EyuXBeta/main/assets/images/eyux.gif" alt="EyuX Web Demo" width="700" style="border-radius: 10px; box-shadow: 0 4px 8px 0 rgba(0, 0, 0, 0.2);"/>
</div>
<br/>

EyuX is more than just a chatbot. It's a versatile mobile and web companion designed to be your assistant, entertainer, and productivity partner. Powered by Google's Gemini models, it features dynamic AI personalities, live web search, AI image generation, interactive code execution, long-term memory, and extensive customization options, all wrapped in a sleek, animated, and user-friendly interface.

---
## 🏗️ Project Structure & Architecture

Below is the current project structure, designed for clarity, scalability, and ease of navigation:

```
EYUXBETA
├── app
│   └── (tabs)
|       ├── index.tsx             // NOW: A clean entry point that renders the main App component.
│       └── storybook.tsx
├── src
│   ├── api                       // For all external API call logic.
│   │   ├── geminiService.ts
│   │   └── tavilyService.ts
│   |
│   ├── components                // Reusable UI components.
│   │   ├── animated              // Purely aesthetic animated components.
│   │   │   ├── AnimatedBackground.tsx
│   │   │   └── StarryBackground.tsx
|   |   |──  AgenticIDE.tsx        // Interactive Code Editor & Previewer
|   |   |── DrawingCanvasModal.tsx // Sketching tool
|   |   |── FlashcardGenerator.tsx // UI for generating cards
|   |   |── FlashcardViewer.tsx   // Interactive Flip-card viewer
|   |   |── MermaidViewer.tsx     // Diagram renderer
|   |   |── SideImageViewer.tsx   // Desktop-specific split-view image viewer
|   |   |── TrialBanner.tsx       // Trial system UI
|   |   |── PythonCell.tsx        // Executes Python codes
│   │   ├── chat                  // Components specific to the chat screen.
│   │   │   ├── ActiveModeIndicator.tsx
│   │   │   ├── AnimatedChatTitle.tsx
│   │   │   ├── ChatInput.tsx
│   │   │   ├── ImageGenerationPlaceholder.tsx
│   │   │   ├── MessageItem.tsx
│   │   │   ├── SpeechControlToast.tsx
│   │   │   ├── TypingIndicator.tsx
│   │   │   └── WebSearchLoader.tsx
│   │   ├── common                // Generic components used across the app.
│   │   │   ├── CodeBlock.tsx
│   │   │   ├── EyuxLogo.tsx
│   │   │   └── GoSuperEyuxButton.tsx
│   │   ├── modals                // All modal components.
│   │   │   ├── ApiKeyPromptModal.tsx
│   │   │   ├── ChatOptionsMenu.tsx
│   │   │   ├── CodeCanvas.tsx
│   │   │   ├── FoldersScreen.tsx
│   │   │   ├── GuidanceModal.tsx
│   │   │   ├── ImageViewerModal.tsx
│   │   │   ├── MemoriesModal.tsx
│   │   │   ├── MoveToFolderModal.tsx
│   │   │   ├── RenameModal.tsx
│   │   │   ├── SchedulesModal.tsx
│   │   │   ├── SelectionModal.tsx
│   │   │   └── SuperEyuXScreen.tsx
│   │   └── navigation            // Components related to navigation (like the drawer).
│   │       └── Drawer.tsx
│   ├── constants                 // All application constants.
│   │   ├── api.ts
│   │   ├── app.ts
│   │   ├── personalities.ts
|   |   ├── flashcard.ts 
│   │   └── storage.ts
│   ├── contexts                  // For React Context providers.
│   │   └── ToastContext.tsx
│   ├── hooks                     // Custom React hooks.
│   │   ├── useNavigationBarStyler.ts
│   │   └── usePrevious.ts
│   ├── screens                   // Top-level screen components.
│   │   ├── ApiKeySetupScreen.tsx
│   │   ├── ChatScreen.tsx
│   │   ├── OnboardingScreen.tsx
│   │   └── SettingsNavigator.tsx   // A new component to manage settings navigation.
│   ├── services                  // Services for managing device features.
│   │   ├── fileService.ts
│   │   ├── notificationService.ts
│   │   └── storageService.ts
│   ├── types                     // Centralized TypeScript types and interfaces.
│   │   └── index.ts
│   ├── utils                     // Helper functions.
│   │   ├── systemInstructions.ts
|   |   ├── TrialBanner.tsx       // Trial system UI
|   |   ├── webNotifications.ts   // Web-specific push notification handler
|   |   ├──
│   └── App.tsx                   // The main application component (formerly AppContent).
├── assets                    // Stays as is (fonts, images).
├── package.json
└── ... (other root config files)
```

---
### 🔒 Security & Data Flow Overview

<div style="overflow-x: auto; white-space: nowrap; text-align: center;">
  <img src="https://raw.githubusercontent.com/Eul45/EyuXBeta/main/assets/images/333.png"
       alt="EyuX Architecture Diagram"
       style="height: auto; max-width: 100%;" />
</div>

---

## 🖼️ Feature Overview

### 🖥️ Desktop & Web Experience
EyuX on the web utilizes the full screen real estate for a powerful dashboard experience.
<table>
<tr>
<td width="50%" align="center">
<strong>Split-View Image Preview</strong>
</td>
<td width="50%" align="center">
<strong>Multi-Thread Tree Visualization</strong>
</td>
</tr>
<tr>
<td>
<img src="https://raw.githubusercontent.com/Eul45/EyuXBeta/main/assets/images/1.png" alt="Split View" width="100%">
<br/>
<em>Clicking an image opens it in a dedicated sidebar without blocking the chat history.</em>
</td>
<td>
<img src="https://raw.githubusercontent.com/Eul45/EyuXBeta/main/assets/images/2.png" alt="Tree View" width="100%">
<br/>
<em>Visualize complex conversation paths and navigate branches like a node graph.</em>
</td>
</tr>
</table>

🛠️ Developer & Study Tools
<table>
<tr>
<td width="50%" align="center">
<strong>Agentic IDE (Code Canvas)</strong>
</td>
<td width="50%" align="center">
<strong>Interactive Flashcards and more</strong>
</td>
</tr>
<tr>
<td>
<img src="https://raw.githubusercontent.com/Eul45/EyuXBeta/main/assets/images/3.png" alt="Code Canvas" width="100%">
<br/>
<em>Edit and Run HTML/CSS/JS code generated by the AI in a live sandbox.</em>
</td>
<td>
<img src="https://raw.githubusercontent.com/Eul45/EyuXBeta/main/assets/images/4.png" alt="Flashcards" width="100%">
<br/>
<em>Turn conversation topics into study decks with flip animations.</em>
</td>
</tr>
</table>

🧠 Mermaid Diagram Visualization
<table>
<tr>
<td width="100%" align="center">
<strong>Mermaid Diagram Rendering</strong>
</td>
</tr>
<tr>
<td>
<img src="https://raw.githubusercontent.com/Eul45/EyuXBeta/main/assets/images/9.png" alt="Mermaid Diagram" width="100%">
<br/>
<em>Generate and visualize flowcharts, sequence diagrams, and system architectures directly from Mermaid syntax.</em>
</td>
</tr>
</table>
<h3>🐍 Python Data Analysis (Client-Side)</h3>
<table>
  <tr>
    <td width="100%" align="center">
      <strong>In-Browser Python Engine</strong>
    </td>
  </tr>
  <tr>
    <td>
      <img src="https://raw.githubusercontent.com/Eul45/EyuXBeta/main/assets/images/python_preview.png" alt="Python Data Analysis" width="100%">
      <br/>
      <em>Powered by Pyodide (WASM). Executes Python code, calculates math/stats with NumPy/Pandas, and renders Matplotlib charts directly in the chat interface without a backend.</em>
    </td>
  </tr>
</table>

EcodeX Multi-File Agentic IDE

<table>
<tr>
<td width="50%" align="center">
<strong>Agentic EcodeX (separate)</strong>
</td>
<td width="50%" align="center">
<strong></strong>
</td>
</tr>
<tr>
<td>
<img src="https://raw.githubusercontent.com/Eul45/EyuXBeta/main/assets/images/11.png" alt="Code Canvas" width="100%">
<br/>
<em>Build & Edit any code file + Run HTML/CSS/JS code generated by the AI in a live sandbox.</em>
</td>
<td>
<img src="https://raw.githubusercontent.com/Eul45/EyuXBeta/main/assets/images/22.png" alt="Flashcards" width="100%">
<br/>
<em>Create multi-file projects (HTML/CSS/JS/Python/TSX), review streaming diffs, and export.</em>
</td>
</tr>
</table>

### 📱 Mobile app & Interactive UI
Optimized for touch, haptics, and quick interactions on Android.

<table>
<tr>
<td width="33%" align="center">
<strong>Data Visualization</strong>
</td>
<td width="33%" align="center">
<strong>Live Web Search</strong>
</td>
<td width="33%" align="center">
<strong>Polls & Interaction</strong>
</td>
</tr>
<tr>
<td valign="top">
<img src="https://raw.githubusercontent.com/Eul45/EyuXBeta/main/assets/images/mobile_charts.png" alt="Data Charts" width="100%">
<br/><br/>
<em>Native rendering of Bar, Line, and Pie charts for data analysis.</em>
</td>
<td valign="top">
<img src="https://raw.githubusercontent.com/Eul45/EyuXBeta/main/assets/images/mobile_search.png" alt="Web Search" width="100%">
<br/><br/>
<em>Real-time browsing with cited sources, summaries, and deep links.</em>
</td>
<td valign="top">
<img src="https://raw.githubusercontent.com/Eul45/EyuXBeta/main/assets/images/mobile_polls.png" alt="Interactive Polls" width="100%">
<br/><br/>
<em>Interactive widgets and polls for instant decision making.</em>
</td>
</tr>
</table>

---

## ✨ Features Showcase

EyuX is packed with features that create a truly interactive and intelligent chat experience.

---

## 🧠 Core AI Capabilities

- **🤖 Dynamic Personalities:** Instantly switch the AI's persona—from a helpful Assistant to a chaotic Storyteller, a witty Gen Z, or even an Unhinged AI.
- **🌐 Live Web Search:** The AI automatically detects when it needs fresh information and uses the Tavily API to search the web for real-time events, news, and data.
- **🎨 AI Image Generation:** Generate images directly in the chat by describing what you want to see using the `/imagine` command.
- **🌿 Multi-Thread Branching:** Visualize your conversation as a tree! Branch off from any message to explore different outcomes without losing the original context.
- **🕵️‍♂️ Agent Mode:** Capable of executing multi-step complex tasks (e.g., "Research X, summarize it in a table, and save it to a folder").
- **💾 Intelligent Memory:** EyuX remembers key facts you share, creating a continuous, personalized conversation. You can also manage these memories manually.
- **⏰ Effortless Reminders:** Set reminders using natural language (e.g., "remind me to check the oven in 10 minutes"), and EyuX will schedule a device notification.
- **🔄 Multi-Model Support:** Switch between different Google Gemini models (e.g., Flash 2.0, Flash 2.5) right from the sidebar to balance speed and power.
- **🔄 Google Drive Cloud Sync: (Web Beta) ** seamless backup and sync of your history across devices using your Google Drive.

---
## 🎓 Study & Developer Tools
- **⚡ Interactive Flashcards:** Automatically generate study flashcards from any conversation and review them in a flip-card interface.
- **📊 Data Visualization:** Renders interactive Line, Bar, and Pie charts directly from data provided by the AI.
- **🧜‍♀️ Mermaid Diagrams:** Renders complex flowcharts, sequence diagrams, and mind maps from text descriptions using Mermaid.js syntax.
- **💻 Agentic IDE:** An interactive coding canvas to edit, run, and preview HTML/CSS/JS code generated by the AI.
- **📐 LaTeX Math Support:** Beautiful rendering of complex mathematical equations.

---

## 📱 User Experience & Interface

- **🎨 Rich Message Rendering:** Full Markdown support for text formatting, plus beautifully rendered code blocks with syntax highlighting and a one-click copy button.
- **🖼️ Interactive Code Canvas:** When the AI provides web code (HTML/CSS/JS), you can open it in an interactive canvas to edit and run it live in a WebView.
- **📎 Versatile Attachments:** Enhance your prompts by attaching images from your gallery, taking a photo, or uploading documents.
- **🗣️ Text-to-Speech:** Have the AI's responses read aloud with an intuitive speech control bar that shows progress.
- **💅 Deep Customization:** Full Dark & Light Mode support. Personalize chat bubble colors for both you and the AI.
- **✨ Rich Animations:** The UI is full of smooth, delightful animations, from the "Super EyuX" screen transition to the animated chat titles and starry backgrounds.

---

## 🗂️ Organization & Data Management

- **🗂️ Chat Folders:** Organize your conversations into custom folders.
- **🤖 Automatic Organization:** Let the AI automatically categorize new chats into the most relevant folder.
- **💾 Full Backup & Restore:** Export all your chats, folders, settings, and memories to a single JSON file and import it on any device.
- **🔑 Secure API Key Management:** Easily add and update your API keys in a dedicated settings screen.

---

## 🛠️ Tech Stack

- **Framework:** React Native with Expo
- **AI:** Google Generative AI (Gemini) & Tavily AI for Web Search
- **State Management:** React Hooks (useState, useContext, useCallback)
- **Animations:** React Native Reanimated
- **Local Storage:** AsyncStorage (Local) & Google Drive API (Cloud)
- **Graphics/Charts:** react-native-svg, react-native-chart-kit
- **UI Components:** @expo/vector-icons, react-native-markdown-display, react-native-webview
- **Math/Diagrams:** react-katex, react-native-webview (for Mermaid/HTML)

---

## 🤝 Project Status & Collaboration

This project is actively developed and used in production.  
The core source code is **not open-source**, as it’s part of a live product and ongoing development.

### You can still contribute by:
- Reporting bugs or issues
- Suggesting new features or improvements
- Giving UX, performance, or scalability feedback
- Sharing ideas or use-cases

### Collaboration
For serious collaboration, partnership, or research opportunities, feel free to reach out directly:

📩 **Email:** eyutechservices@gmail.com  
💬 **Telegram:** [@Eul_zzz](https://t.me/Eul_zzz)

---

Thank you for your interest and support!

---

## 🙏 Acknowledgments

- Expo Team for their incredible tools and platform.
- Google for the powerful Gemini models.
- Tavily for the excellent search API.
- All the creators of the open-source libraries used in this project.

<div align="center">
  <strong>&lt;/&gt; Made by Eyuel Engida</strong>
</div>

---