# Arion: Cross‑Platform Desktop App for Agentic Geospatial AI Analysis 🎉 v0.10.1 Released! Arion v0.10.1 is now available with Codex integration, connector tabs, and UI improvements. Check out the release notes for full details! 📦 Binary Releases Coming Soon! Binary builds for Windows , macOS , and Linux will be available soon. Stay tuned! Arion is a **cross-platform desktop application** designed for advanced geospatial analysis and agentic workflows. Built with Electron, React (TypeScript), and Vite, Arion runs natively on **Windows, macOS, and Linux**, empowering users to leverage local and cloud-based Large Language Models (LLMs), integrate custom Model Context Protocol (MCP) servers, and utilize a plugin system for extended capabilities. ## 🎥 Demo Video Click to watch the Arion introduction video ## Core Features - **Interactive Chat Interface:** Communicate with LLMs for geospatial queries, analysis, and task automation. Supports various providers (OpenAI, Google Gemini, Azure, Anthropic, Ollama) via the Vercel AI SDK. - **Dynamic Map Visualization:** Render and interact with geospatial data using MapLibre GL. - **LLM Tool Integration:** - Built-in tools for map manipulation (add features, buffers, set view), UI control, and knowledge base queries. - Support for user-defined MCP servers, allowing agents to access external Python/TypeScript tools and data sources. - **Knowledge Base Integration:** Ingest documents (PDF, DOCX, TXT) into a local vector store (PGlite with pgvector) for Retrieval Augmented Generation (RAG). - **Local LLM Support:** Configure and use local LLMs via Ollama. - **Agentic Workflows (Planned):** Future support for running Python (LangGraph/CrewAI) and TypeScript agents in isolated processes, orchestrated by the application. - **Plugin System (Planned):** Extend Arion's functionality with custom plugins for data connectors, visualization providers, MCP tools, and agent providers. - **SQLite/SpatiaLite Backend:** Manages application settings, chat history, and plugin configurations. SpatiaLite for advanced geospatial data operations (integration in progress). ## Technology Stack - **Desktop Framework:** Electron - **Frontend:** React, TypeScript, Vite, Tailwind CSS - **Backend (Main Process):** Node.js, TypeScript - **Mapping:** MapLibre GL - **AI/Chat:** Vercel AI SDK, LangChain (for future agent runtimes) - **LLM Tools:** Model Context Protocol (MCP) - `@modelcontextprotocol/sdk` - **Local Vector Store (Knowledge Base):** PGlite with `pgvector` extension - **Database (Application Data):** SQLite (using `better-sqlite3`) - **Build & Packaging:** Electron Vite, Electron Builder - **Linting & Formatting:** ESLint, Prettier ## Project Structure - `src/main/`: Electron Main process code (Node.js environment). - `src/renderer/src/`: Electron Renderer process code (React UI). - `src/preload/`: Electron Preload script for secure IPC. - `src/shared/`: Code shared between Main and Renderer (e.g., IPC types). - `plugins/` (Planned): Top-level directory for user-installed plugins. - `python-agents/` (Planned): Directory for Python-based agent runtimes. ## Recommended IDE Setup - [VSCode](https://code.visualstudio.com/) + [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) + [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) ## Project Setup ### Prerequisites - **Node.js 22** or higher - **npm** 8 or higher ### Install Dependencies ```bash npm install ``` ### Development Run the application in development mode with hot reloading: ```bash npm run dev ``` ### Build for Production Arion uses native Node modules (`better-sqlite3`, `keytar`) that require platform-specific build tools. #### Windows Requires Visual Studio Build Tools (C++ workload) or `windows-build-tools`: ```bash npm run build:win ``` Produces an NSIS installer (`arion- -setup.exe`) for x64. To build without code signing: ```bash npm run build:win:unsigned ``` #### macOS Requires X