|
Arion v0.3.0 is now available with improved tool mapping, PostgreSQL connection support, and migration to Vercel AI SDK v5. |
|
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.
Click to watch the Arion introduction video
- 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).
- 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
pgvectorextension - Database (Application Data): SQLite (using
better-sqlite3) - Build & Packaging: Electron Vite, Electron Builder
- Linting & Formatting: ESLint, Prettier
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.
- Node.js 22 or higher
- npm 8 or higher
npm installRun the application in development mode with hot reloading:
npm run devBuild the application for packaging:
# For Windows
npm run build:win
# For macOS
npm run build:mac
# For Linux
npm run build:linuxWe welcome contributions from the community! Please see our Contributing Guide for details on:
- 🚀 Getting started with development
- 📋 Types of contributions we're looking for
- 🛠️ Development guidelines and coding standards
- 📝 Licensing terms for contributors
Quick start: Fork the repository, make your changes, and submit a pull request.
For questions: [email protected]
Arion is free software released under the GNU General Public License v3.0 or later.
- You may use, modify, and redistribute the project under the GPL terms (including commercial use).
- Distributions and derivative works must provide source code and remain licensed under the GPL.
- See the LICENSE file for the complete text and guidance on applying the GPL to your changes.