evoflux

Evoflux é um espaço de trabalho desktop open-source e local-first projetado para equipes de agentes de IA. Ele unifica conversas de agentes, arquivos, terminal, navegador, git e verificação em uma única interface, oferecendo dois modos principais: **Work** para tarefas gerais e **Coding** para desenvolvimento com reconhecimento de repositório. As principais capacidades incluem: - **Modos Work e Coding** tanto para tarefas pontuais quanto para repositórios persistentes. - **Equipes de líder e especialistas** onde cada agente pode ter seu próprio modelo, habilidades, ferramentas e permissões. - **Traga seu próprio modelo** com suporte a cerca de 200 provedores hospedados, em nuvem, roteados ou locais, selecionáveis por agente. - **Coding com reconhecimento de repositório** com busca de código, relações entre símbolos, feedback de LSP, fluxos de trabalho git e diffs revisáveis. - **Computer App Control** permitindo que um agente opere uma única janela de aplicativo desktop no Windows ou macOS através de sua árvore de acessibilidade, em segundo plano, com pré-visualização ao vivo e aprovação por ação. - **WebBridge** permitindo que agentes trabalhem no seu navegador Chrome ou Edge real com logins existentes através de um relay emparelhado e verificado por políticas. - **Controle local** com histórico inspecionável, permissões, sandboxing e redação de segredos/PII de saída. - **Memória, plugins, MCP, agendamento e um navegador integrado**. ## Download As versões desktop estão disponíveis em [GitHub Releases](https://github.com/evoelsewhere/evoflux/releases) para macOS, Windows e Linux. Os pacotes incluem o sidecar Python nativo. Os pacotes Linux devem ser instalados via gerenciador de pacotes do sistema (por exemplo, `sudo apt install ./EvoFlux_*_amd64.deb`). O WebBridge é distribuído separadamente no [repositório evo-webbridge](https://github.com/evoelsewhere/evo-webbridge). ## Executar a partir do código-fonte ### Requisitos - Python 3.12+ - [uv](https://docs.astral.sh/uv/) - [Bun](https://bun.sh/) - Rust e a [Tauri CLI](https://v2.tauri.app/start/prerequisites/) - Pré-requisitos do Tauri para o seu sistema operacional ### Configuração ```sh git clone https://github.com/evoelsewhere/evoflux.git cd evoflux uv sync cd web && bun install && cd .. ``` Inicie o aplicativo de desenvolvimento: ```sh # React UI + local API make dev-web # React UI + local API + Tauri desktop shell make dev-desktop ``` `make dev` é um alias para `make dev-web`. O servidor web é uma superfície interna de desenvolvimento; o produto é um aplicativo desktop. Na primeira inicialização, conecte um provedor de modelo e então inicie uma sessão Work ou abra um repositório no modo Coding. ## Documentação Contratos e guias detalhados estão em [`documents/`](documents/): - [Índice da documentação](documents/README.md) - [Guia de Agent Plugins](documents/guides/agent-plugins.md) - [Arquitetura de Coding](documents/architecture/) - [Guia de desenvolvimento](documents/development/README.md) ## Arquitetura A stack é: Tauri desktop shell → React UI ↔ sidecar FastAPI local → estado local, runtime de agentes, repositórios e provedores de modelo. O runtime principal e o estado do projeto permanecem na máquina do usuário; os provedores de modelo são substituíveis enquanto o harness lida com contexto, ferramentas, permissões, memória e verificação. ## Estrutura do projeto - `app/` – sidecar FastAPI, agentes, ferramentas de coding, memória, agendador, MCP - `web/` – interface React - `desktop/` – shell Tauri e empacotamento do sidecar Python - `seed/` – blueprints de Work e Coding, habilidades e configuração - `tests/` – testes de backend e frontend - `documents/` – arquitetura, contratos de recursos, guias e registros ## Contribuindo Issues e pull requests são bem-vindos. Mantenha as mudanças focadas e inclua a menor execução de teste relevante. Relate vulnerabilidades de forma privada via GitHub Security Advisories. ## Licença Apache License 2.0.