bcc7632008f4b2d7faba03ff1ec1bb6ed81fc45c
agx
agx is a desktop application that lets you explore and query data through a modern interface. It's built with Tauri, SvelteKit and Plot, and can work in two ways: as a native desktop app using (Clickhouse), or as a web interface connected to remote server instance.
Preview
Features
- Native desktop application performance with web technologies
- Interactive SQL query editor with syntax highlighting LLM Integration
- Schema browser for exploring data structure
- Results displayed in a tabular format
- Support for drag & drop file operations
- Cross-platform compatibility (macOS, Linux, Windows)
Getting Started
→ Native
Get the latest release from GitHub.
→ Live
Ollama Integration
To use your local Ollama models with the live version (https://agx.app), run:
OLLAMA_ORIGINS="https://app.agx" ollama serve
→ Docker Local
- Clone the repository:
git clone https://github.com/agnosticeng/agx && cd agx
- Run with docker compose:
docker compose up
- Access the application via http://localhost:8080
Installing Agnostic UDF
Install Agnostic ClickHouse UDFs, to enable bonus features, with a single command:
curl -fsSL https://raw.githubusercontent.com/agnosticeng/agx/main/scripts/install_agnostic_udfs.sh | sh
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Prerequisites
- Node.js (v16 or later)
- Rust toolchain
- System dependencies for Tauri
Project Structure
agx/
├── src/ # Frontend source code (SvelteKit)
│ ├── lib/ # Shared components
│ └── routes/ # Application routes
├── src-tauri/ # Backend source code (Rust)
│ ├── src/ # Rust source files
│ └── Cargo.toml # Rust dependencies
├── package.json # Node.js dependencies
└── README.md
License
This project is licensed under the MIT License - see the LICENSE file for details.
The MIT License is one of the most popular open-source licenses because it:
- Is simple and permissive
- Allows commercial use
- Allows modification and distribution
- Allows private use
- Has minimal restrictions
- Is compatible with many other licenses
Languages
Svelte
62.3%
TypeScript
29.6%
Shell
2.4%
Rust
2.2%
CSS
2.1%
Other
1.4%
