feat: initialize Tauri application with Preact framework
- Added main application logic in `src-tauri/src/lib.rs` and `src-tauri/src/main.rs`. - Configured Tauri settings in `tauri.conf.json`. - Created basic styling in `src/App.css`. - Implemented main application component in `src/App.tsx` with greeting functionality. - Included Preact logo in `src/assets/preact.svg`. - Set up rendering in `src/main.tsx`. - Defined TypeScript environment in `vite-env.d.ts` and configured TypeScript settings in `tsconfig.json` and `tsconfig.node.json`. - Configured Vite for Tauri development in `vite.config.ts`.
This commit is contained in:
Evandro Fonseca Junior committed
1 parent
98fde58d77
commit
ce33464c6e
40 files changed
+515
-23
No files matched your search
@@ -0,0 +1,103 @@
|
||||
# localaiapp
|
||||
|
||||
O **localaiapp** é um orquestrador de inteligência artificial local de alta performance, construído sobre a stack **Tauri (Rust)** para o core, **Preact** para a interface de usuário de baixo footprint, e **Python (Llama)** como motor de inferência via Sidecar.
|
||||
|
||||
---
|
||||
|
||||
## 1. Abordagem de Princípios Primeiros (Arquitetura)
|
||||
|
||||
A escolha do modelo **Sidecar** em detrimento de um servidor local (HTTP) baseia-se na **eficiência de IPC (Inter-Process Communication)** e **gestão de ciclo de vida**:
|
||||
|
||||
- **Isolamento de Processo:** O motor de IA (Python) roda como um processo filho binário. Se a inferência travar, o core em Rust pode reiniciá-lo sem derrubar a UI.
|
||||
- **Segurança de Memória:** O Rust atua como um "vigia", garantindo que os recursos de GPU/RAM consumidos pelo Llama sejam liberados imediatamente após o encerramento do app.
|
||||
- **Distribuição:** Ao compilar o Python com Nuitka ou PyInstaller, eliminamos a necessidade de o usuário final ter o Python instalado no sistema.
|
||||
|
||||
---
|
||||
|
||||
## 2. Setup do Ambiente de Desenvolvimento
|
||||
|
||||
### Pré-requisitos de Engenharia
|
||||
|
||||
| Componente | Windows (PowerShell) | Manjaro Linux (Pacman/Pamac) |
|
||||
| ------------------- | ------------------------------ | ------------------------------- |
|
||||
| **Rust** | `rustup` (MSVC toolchain) | `rustup` ou `pacman -S rust` |
|
||||
| **Node.js** | `winget install OpenJS.NodeJS` | `sudo pacman -S nodejs npm` |
|
||||
| **C++ Build Tools** | Visual Studio Build Tools 2022 | `sudo pacman -S base-devel` |
|
||||
| **Webview Engine** | WebView2 (Nativo) | `sudo pacman -S webkit2gtk-4.1` |
|
||||
| **Python Tooling** | `python -m pip install nuitka` | `sudo pacman -S python-pip` |
|
||||
|
||||
### Instalação e Inicialização
|
||||
|
||||
1. **Clone o repositório:**
|
||||
|
||||
```bash
|
||||
git clone https://github.com/seu-usuario/localaiapp.git
|
||||
cd localaiapp
|
||||
|
||||
```
|
||||
|
||||
2. **Instale as dependências do Frontend:**
|
||||
|
||||
```bash
|
||||
npm install
|
||||
|
||||
```
|
||||
|
||||
3. **Preparação do Sidecar (Python):**
|
||||
> **Nota Crítica:** O Tauri exige que o binário sidecar siga a nomenclatura `[nome]-[target-triple]`.
|
||||
|
||||
```bash
|
||||
# Exemplo de comando para gerar o binário (dentro da pasta /src-python)
|
||||
python -m Nuitka --standalone --onefile main.py
|
||||
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. Estrutura do Projeto
|
||||
|
||||
```plaintext
|
||||
localaiapp/
|
||||
├── src/ # Frontend (Preact + Typescript)
|
||||
│ ├── components/ # Componentes atômicos
|
||||
│ └── main.tsx # Entry point do Preact
|
||||
├── src-tauri/ # Core do Sistema (Rust)
|
||||
│ ├── bin/ # Binários Sidecar (Python compilado)
|
||||
│ ├── src/ # Lógica de ponte Rust-UI
|
||||
│ └── tauri.conf.json # Configuração de permissões e sidecars
|
||||
├── src-python/ # Motor de IA (Llama-cpp-python)
|
||||
│ ├── main.py # Script principal de inferência
|
||||
│ └── requirements.txt
|
||||
└── public/ # Assets estáticos
|
||||
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. Fluxo de Execução (Engenharia de Dados)
|
||||
|
||||
1. **Frontend (Preact):** Dispara um evento `invoke('start_inference', { prompt: '...' })`.
|
||||
2. **Bridge (Rust):** O Tauri recebe o comando, valida os parâmetros e comunica-se via `stdin` ou `localhost socket` com o processo Sidecar.
|
||||
3. **Sidecar (Python):** O Llama processa os tensores, gera o stream de tokens e devolve ao Rust.
|
||||
4. **Update (UI):** O Preact utiliza **Signals** para atualizar a interface em tempo real com o mínimo de re-renders.
|
||||
|
||||
---
|
||||
|
||||
## 5. Roadmap de Desenvolvimento
|
||||
|
||||
- [x] Setup Inicial (Tauri + Preact + TS)
|
||||
- [ ] Implementação do Sidecar Llama (C++ Bindings)
|
||||
- [ ] Suporte a Aceleração de Hardware (CUDA/Vulkan)
|
||||
- [ ] **Futuro:** Módulo de Web Search (Integração de busca via Python e extração de contexto).
|
||||
|
||||
---
|
||||
|
||||
## 6. Verificação de Lacunas (Common Pitfalls)
|
||||
|
||||
- **PATH no Windows:** Certifique-se de que o compilador C++ está no PATH, ou o Tauri não conseguirá compilar os bindings do Rust.
|
||||
- **Permissões no Linux:** No Manjaro, o WebKitGTK pode exigir permissões específicas de sandbox dependendo da versão do Kernel.
|
||||
- **Sidecar Naming:** O erro mais comum é não incluir o _target triple_ (ex: `x86_64-unknown-linux-gnu`) no nome do binário dentro de `src-tauri/bin`.
|
||||
|
||||
---
|
||||
|
||||
**Como você é um engenheiro e estamos no início, gostaria que eu criasse o script inicial em Python para o Sidecar já com as tipagens básicas ou prefere focar na configuração do `tauri.conf.json` para reconhecer o binário?**
|
||||
Reference in new issue
Block a user