agnosticeng/agx

어떤 프로젝트인가요?

핵심 기능

• 01구문 강조 기능을 갖춘 대화형 SQL 편집기
• 02테이블 구조를 살펴보는 스키마 브라우저
• 03표 형태의 쿼리 결과 화면
• 04파일 드래그 앤 드롭 작업
• 05로컬 LLM 모델을 위한 Ollama 연동
• 06macOS, Linux, Windows에서 실행

활용 사례

• 별도의 프런트엔드를 만들지 않고 ClickHouse 데이터셋 조회
• 쿼리를 작성하기 전에 익숙하지 않은 데이터베이스 스키마 탐색
• Ollama로 로컬 LLM 지원 분석 실행
• Docker로 공유 SQL 분석 인터페이스 자체 호스팅

빠른 시작

1. 1

   저장소를 클론합니다

   git clone https://github.com/agnosticeng/agx && cd agx
2. 2

   Docker Compose로 실행합니다

   docker compose up
3. 3

   브라우저에서 localhost의 포트 8080으로 접속해 애플리케이션을 엽니다

사용 전 알아둘 점

• !네이티브 데스크톱 앱은 Tauri로 빌드되며, 소스에서 빌드하려면 Rust 툴체인과 시스템 종속성이 필요합니다.
• !라이브 사이트와 Ollama를 연동하려면 특정 OLLAMA_ORIGINS 설정으로 Ollama를 실행해야 합니다.

토픽

자주 묻는 질문

agx은(는) 무엇인가요?

SQL로 데이터를 탐색하고 조회하는 ClickHouse 기반 데스크톱 및 웹 앱으로, LLM 지원 기능을 선택적으로 제공합니다. agx는 최신 인터페이스에서 SQL 쿼리를 작성하고 실행해 데이터를 살펴볼 수 있는 데이터 탐색 도구입니다. Tauri, SvelteKit, Observable Plot으로 만들었으며, ClickHouse를 백엔드로 사용하는 네이티브 데스크톱 앱이나 원격 서버 인스턴스에 연결하는 웹 인터페이스로 실행할 수 있습니다.

agx은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

agx은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

agx은(는) 아직 유지보수되고 있나요?

6개월 이상 커밋 없음. agx의 마지막 커밋은 2026년 3월 10일입니다.

agx은(는) 어디에 사용할 수 있나요?

별도의 프런트엔드를 만들지 않고 ClickHouse 데이터셋 조회 쿼리를 작성하기 전에 익숙하지 않은 데이터베이스 스키마 탐색 Ollama로 로컬 LLM 지원 분석 실행 Docker로 공유 SQL 분석 인터페이스 자체 호스팅

agx는 어떻게 설치하나요?

저장소를 클론합니다: git clone https://github.com/agnosticeng/agx && cd agx Docker Compose로 실행합니다: docker compose up 브라우저에서 localhost의 포트 8080으로 접속해 애플리케이션을 엽니다

agx은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/agnosticeng/agx