https://github.com/agnosticeng/agx
Query and explore local and remote data with Clickhouse
https://github.com/agnosticeng/agx
clickhouse d3 data rust svelte
Last synced: 8 months ago
JSON representation
Query and explore local and remote data with Clickhouse
- Host: GitHub
- URL: https://github.com/agnosticeng/agx
- Owner: agnosticeng
- License: mit
- Created: 2024-09-17T20:19:31.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-02-04T18:57:42.000Z (over 1 year ago)
- Last Synced: 2025-02-04T19:41:22.663Z (over 1 year ago)
- Topics: clickhouse, d3, data, rust, svelte
- Language: Svelte
- Homepage: https://ethereum.agx.app
- Size: 671 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-clickhouse - agnosticeng/agx - agx is an AI-powered integrated analytics desktop application that enables interactive data exploration and querying using ClickHouse's embedded database or a remote ClickHouse server. (UIs / GUI)
README
# agx
**_agx_** is a desktop application that lets you explore and query data through a modern interface. It's built with [Tauri](https://tauri.app/), [SvelteKit](https://kit.svelte.dev/) and [Plot](https://observablehq.com/@observablehq/plot), and can work in two ways: as a native desktop app using ([Clickhouse](https://github.com/clickhouse/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](https://github.com/agnosticeng/agx/releases).
### → Live
https://agx.app
#### Ollama Integration
To use your local Ollama models with the live version (https://agx.app), run:
```bash
OLLAMA_ORIGINS="https://app.agx" ollama serve
```
### → Docker Local
1. Clone the repository:
```bash
git clone https://github.com/agnosticeng/agx && cd agx
```
2. Run with docker compose:
```bash
docker compose up
```
3. Access the application via http://localhost:8080
## Installing Agnostic UDF
Install [Agnostic ClickHouse UDFs](https://github.com/agnosticeng/clickhouse-evm), to enable bonus features, with a single command:
```bash
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](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