Vane

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 36,192 Open GitHub ↗

Vane은 AI 기반의 답변 엔진입니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Vane 🔍

[![GitHub Repo stars](https://img.shields.io/github/stars/ItzCrazyKns/Vane?style=social)](https://github.com/ItzCrazyKns/Vane/stargazers)
[![GitHub forks](https://img.shields.io/github/forks/ItzCrazyKns/Vane?style=social)](https://github.com/ItzCrazyKns/Vane/network/members)
[![GitHub watchers](https://img.shields.io/github/watchers/ItzCrazyKns/Vane?style=social)](https://github.com/ItzCrazyKns/Vane/watchers)
[![Docker Pulls](https://img.shields.io/docker/pulls/itzcrazykns1337/vane?color=blue)](https://hub.docker.com/r/itzcrazykns1337/vane)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/ItzCrazyKns/Vane/blob/master/LICENSE)
[![GitHub last commit](https://img.shields.io/github/last-commit/ItzCrazyKns/Vane?color=green)](https://github.com/ItzCrazyKns/Vane/commits/master)
[![Discord](https://dcbadge.limes.pink/api/server/26aArMy8tT?style=flat)](https://discord.gg/26aArMy8tT)

Vane은 사용자의 하드웨어에서 완전히 실행되는 **개인 정보 보호 중심의 AI 답변 엔진**입니다. 방대한 인터넷의 지식과 **로컬 LLM**(Ollama) 및 클라우드 제공업체(OpenAI, Claude, Groq)에 대한 지원을 결합하여, 검색 내용을 완전히 비밀로 유지하면서 **출처가 명시된** 정확한 답변을 제공합니다.

![preview](https://raw.githubusercontent.com/ItzCrazyKns/Vane/master/.assets/vane-screenshot.png)

아키텍처와 작동 방식에 대해 더 알고 싶으신가요? [여기](https://github.com/ItzCrazyKns/Vane/tree/master/docs/architecture/README.md)에서 확인하실 수 있습니다.

## ✨ 주요 기능

🤖 **모든 주요 AI 제공업체 지원** - Ollama를 통해 로컬 LLM을 사용하거나 OpenAI, Anthropic Claude, Google Gemini, Groq 등에 연결하세요. 필요에 따라 모델을 자유롭게 조합하여 사용할 수 있습니다.

⚡ **스마트 검색 모드** - 빠른 답변이 필요할 때는 Speed Mode, 일상적인 검색에는 Balanced Mode, 깊이 있는 조사가 필요할 때는 Quality Mode를 선택하세요.

🧭 **출처 선택** - 웹, 토론, 학술 논문을 검색하세요. 더 많은 출처와 통합 기능이 준비 중입니다.

🧩 **위젯** - 날씨, 계산, 주가 및 기타 빠른 조회와 같이 관련성이 있을 때 나타나는 유용한 UI 카드입니다.

🔍 **SearxNG 기반 웹 검색** - 정체를 숨기면서 여러 검색 엔진에 액세스하세요. 더 나은 결과를 위해 Tavily 및 Exa 지원이 곧 추가될 예정입니다.

📷 **이미지 및 비디오 검색** - 텍스트 결과와 함께 시각적 콘텐츠를 찾으세요. 이제 검색이 단순히 기사에만 국한되지 않습니다.

📄 **파일 업로드** - 문서를 업로드하고 그에 대한 질문을 하세요. PDF, 텍스트 파일, 이미지 등 Vane은 모두 이해합니다.

🌐 **특정 도메인 검색** - 찾고자 하는 위치를 알 때 검색 범위를 특정 웹사이트로 제한하세요. 기술 문서나 연구 논문에 적합합니다.

💡 **스마트 제안** - 입력하는 동안 지능적인 검색 제안을 받아 더 나은 쿼리를 작성할 수 있도록 도와줍니다.

📚 **Discover** - 하루 동안 흥미로운 기사와 트렌드 콘텐츠를 찾아보세요. 검색하지 않고도 최신 정보를 유지할 수 있습니다.

🕒 **검색 기록** - 모든 검색 결과가 로컬에 저장되어 언제든지 다시 확인할 수 있습니다. 당신의 연구 결과는 절대 사라지지 않습니다.

✨ **추가 기능 예정** - 커뮤니티 피드백을 바탕으로 새로운 기능을 적극적으로 개발하고 있습니다. Discord에 참여하여 Vane의 미래를 함께 만들어 주세요!

## Sponsors

Vane의 개발은 스폰서분들의 너그러운 후원으로 이루어집니다. 여러분의 기여 덕분에 이 프로젝트를 무료로, 오픈 소스로, 그리고 모두가 이용할 수 있도록 유지할 수 있습니다.

### **✨ [Try Warp - The AI-Powered Terminal →](https://www.warp.dev/vane)**

Warp는 AI 기반 기능, 현대적인 UX, 그리고 매우 빠른 성능으로 개발 워크플로우를 혁신하고 있습니다. 전 세계 유수 기업의 개발자들이 사용하고 있습니다.

</div>

---

또한, 다음과 같은 파트너분들의 아낌없는 지원에 감사드립니다.

## Installation

Vane을 설치하는 방법은 크게 두 가지입니다 - Docker 사용, Docker 미사용. Docker 사용을 강력히 권장합니다.

### Docker로 시작하기 (권장)

Vane은 Docker를 사용하여 쉽게 실행할 수 있습니다. 다음 명령어를 실행하세요:

```bash
docker run -d -p 3000:3000 -v vane-data:/home/vane/data --name vane itzcrazykns1337/vane:latest
```

이 명령은 SearxNG 검색 엔진이 포함된 Vane 컨테이너를 가져와 시작합니다. 실행 후 브라우저를 열고 http://localhost:3000으로 이동하세요. 설정 화면에서 설정(API 키, 모델 등)을 직접 구성할 수 있습니다.

**참고**: 이미지에 Vane과 SearxNG가 모두 포함되어 있어 추가 설정이 필요하지 않습니다. `-v` 플래그는 데이터와 업로드된 파일을 위한 영구 볼륨을 생성합니다.

#### 자체 SearxNG 인스턴스로 Vane 사용하기

이미 SearxNG를 실행 중이라면 Vane의 slim 버전을 사용할 수 있습니다:

```bash
docker run -d -p 3000:3000 -e SEARXNG_API_URL=http://your-searxng-url:8080 -v vane-data:/home/vane/data --name vane itzcrazykns1337/vane:slim-latest
```

**중요**: SearxNG 인스턴스에 다음 설정이 되어 있는지 확인하세요:

- 설정에서 JSON 형식이 활성화되어 있어야 함
- Wolfram Alpha 검색 엔진이 활성화되어 있어야 함

`http://your-searxng-url:8080`을 실제 SearxNG URL로 바꾸세요. 그런 다음 http://localhost:3000의 설정 화면에서 AI 제공업체 설정을 구성하세요.

#### 고급 설정 (소스에서 빌드)

소스에서 빌드하거나 더 세밀한 제어가 필요한 경우:

1. 시스템에 Docker가 설치되어 있고 실행 중인지 확인하세요.
2. Vane 저장소를 클론합니다:

```bash
   git clone https://github.com/ItzCrazyKns/Vane.git
   ```

3. 클론 후 프로젝트 파일이 포함된 디렉토리로 이동합니다.

4. Docker를 사용하여 빌드하고 실행합니다:

```bash
   docker build -t vane .
   docker run -d -p 3000:3000 -v vane-data:/home/vane/data --name vane vane
   ```

5. http://localhost:3000에서 Vane에 접속하여 설정 화면에서 설정을 구성하세요.

**참고**: 컨테이너가 빌드된 후에는 터미널을 열지 않고도 Docker에서 직접 Vane을 시작할 수 있습니다.

### Docker 미사용 설치

1. SearXNG를 설치하고 SearXNG 설정에서 `JSON` 형식을 허용하세요. Wolfram Alpha 검색 엔진도 활성화되어 있는지 확인하세요.
2. 저장소를 클론합니다:

```bash
   git clone https://github.com/ItzCrazyKns/Vane.git
   cd Vane
   ```

3. 의존성을 설치합니다:

```bash
   npm i
   ```

4. 애플리케이션을 빌드합니다:

```bash
   npm run build
   ```

5. 애플리케이션을 시작합니다:

```bash
   npm run start
   ```

6. 브라우저를 열고 http://localhost:3000으로 이동하여 설정을 완료하고 설정 화면에서 API 키, 모델, SearxNG URL 등을 구성하세요.

**참고**: 특히 환경 변수 및 의존성 관리를 단순화해주므로 Docker 사용을 권장합니다.

업데이트 등 자세한 내용은 [설치 문서](https://github.com/ItzCrazyKns/Vane/tree/master/docs/installation)를 참조하세요.

### Troubleshooting

#### 로컬 OpenAI-API 호환 서버

Vane에서 채팅 모델 제공업체를 구성하지 않았다는 메시지가 표시되면 다음을 확인하세요:

1. 서버가 `127.0.0.1`이 아닌 `0.0.0.0`에서 실행 중이며, API URL에 입력한 포트와 동일한지 확인하세요.
2. 로컬 LLM 서버에 로드된 정확한 모델 이름을 지정했는지 확인하세요.
3. 정확한 API 키를 지정했는지 확인하세요. API 키가 정의되지 않은 경우, 빈칸으로 두지 말고 API 키 필드에 _아무 내용이라도_ 입력하세요.

#### Ollama 연결 오류

Ollama 연결 오류가 발생하는 경우, 백엔드가 Ollama API에 연결할 수 없기 때문일 가능성이 큽니다. 이 문제를 해결하려면 다음을 수행하세요:

1. **Ollama API URL 확인:** 설정 메뉴에서 API URL이 올바르게 설정되었는지 확인하세요.
2. **OS별 API URL 업데이트:**

- **Windows:** `http://host.docker.internal:11434` 사용
   - **Mac:** `http://host.docker.internal:11434` 사용
   - **Linux:** `http://<host의_개인_ip>:11434` 사용

다른 포트를 사용하는 경우 포트 번호를 조정하세요.

3. **Linux 사용자 - Ollama를 네트워크에 노출:**

- `/etc/systemd/system/ollama.service` 파일 내에 `Environment="OLLAMA_HOST=0.0.0.0:11434"`를 추가해야 합니다. (다른 포트를 사용하는 경우 포트 번호를 변경하세요.) 그런 다음 `systemctl daemon-reload`로 systemd 매니저 구성을 다시 로드하고, `systemctl restart ollama`로 Ollama를 재시작하세요. 자세한 내용은 [Ollama 문서](https://github.com/ollama/ollama/blob/main/docs/faq.md#setting-environment-variables-on-linux)를 참조하세요.

- 방화벽에 의해 포트(기본값 11434)가 차단되지 않았는지 확인하세요.

#### Lemonade 연결 오류

Lemonade 연결 오류가 발생하는 경우, 백엔드가 Lemonade API에 연결할 수 없기 때문일 가능성이 큽니다. 이 문제를 해결하려면 다음을 수행하세요:

1. **Lemonade API URL 확인:** 설정 메뉴에서 API URL이 올바르게 설정되었는지 확인하세요.
2. **OS별 API URL 업데이트:**

- **Windows:** `http://host.docker.internal:8000` 사용
   - **Mac:** `http://host.docker.internal:8000` 사용
   - **Linux:** `http://<host의_개인_ip>:8000` 사용

다른 포트를 사용하는 경우 포트 번호를 조정하세요.

3. **Lemonade 서버 실행 확인:**

- Lemonade 서버가 실행 중이며 구성된 포트(기본값 8000)에서 액세스 가능한지 확인하세요.
   - Lemonade가 localhost(`127.0.0.1`)뿐만 아니라 모든 인터페이스(`0.0.0.0`)에서 연결을 수락하도록 구성되었는지 확인하세요.
   - 방화벽에 의해 포트(기본값 8000)가 차단되지 않았는지 확인하세요.

## Using as a Search Engine

Vane을 Google이나 Bing과 같은 기존 검색 엔진의 대안으로 사용하고 싶거나, 브라우저 검색창에서 빠르게 접속할 수 있는 바로가기를 추가하려면 다음 단계를 따르세요:

1. 브라우저 설정을 엽니다.
2. '검색 엔진' 섹션으로 이동합니다.
3. 다음 URL로 새 사이트 검색을 추가합니다: `http://localhost:3000/?q=%s`. Vane이 로컬에 호스팅되지 않은 경우 `localhost`를 IP 주소나 도메인 이름으로, `3000`을 포트 번호로 바꾸세요.
4. 추가 버튼을 클릭합니다. 이제 브라우저 검색창에서 Vane을 직접 사용할 수 있습니다.

## Using Vane's API

Vane은 강력한 검색 엔진을 자신의 애플리케이션에 통합하려는 개발자를 위해 API를 제공합니다. 검색을 실행하고, 여러 모델을 사용하며, 쿼리에 대한 답변을 얻을 수 있습니다.

자세한 내용은 [여기](https://github.com/ItzCrazyKns/Vane/tree/master/docs/API/SEARCH.md)에서 전체 문서를 확인하세요.

## Expose Vane to network

Vane은 Next.js 기반으로 실행되며 모든 API 요청을 처리합니다. 동일한 네트워크에서 즉시 작동하며 포트 포워딩을 통해서도 계속 접속 가능합니다.

## One-Click Deployment

[![Deploy to Sealos](https://raw.githubusercontent.com/labring-actions/templates/main/Deploy-on-Sealos.svg)](https://usw.sealos.io/?openapp=system-template%3FtemplateName%3Dperplexica)
[![Deploy to RepoCloud](https://d16t0pc4846x52.cloudfront.net/deploylobe.svg)](https://repocloud.io/details/?app_id=267)
[![Run on ClawCloud](https://raw.githubusercontent.com/ClawCloud/Run-Template/refs/heads/main/Run-on-ClawCloud.svg)](https://template.run.claw.cloud/?referralCode=U11MRQ8U9RM4&openapp=system-fastdeploy%3FtemplateName%3Dperplexica)
[![Deploy on Hostinger](https://assets.hostinger.com/vps/deploy.svg)](https://www.hostinger.com/vps/docker-hosting?compose_url=https://raw.githubusercontent.com/ItzCrazyKns/Vane/refs/heads/master/docker-compose.yaml)

## Upcoming Features

- [ ] 더 많은 위젯, 통합 기능, 검색 출처 추가
- [ ] 커스텀 에이전트 생성 기능 추가 (이름 미정)
- [ ] 인증 기능 추가

## Support Us

Vane이 유용하다고 생각하신다면 GitHub에서 별(star)을 눌러주세요. 더 많은 사람들이 Vane을 발견하고 새로운 기능을 개발하는 데 큰 도움이 됩니다. 여러분의 지원에 진심으로 감사드립니다.

### Donations

프로젝트 유지를 위한 후원도 받고 있습니다. 기여하고 싶으신 분은 다음 옵션을 사용하여 후원하실 수 있습니다. 지원해 주셔서 감사합니다!

| Ethereum                                              |
| ----------------------------------------------------- |
| Address: `0xB025a84b2F269570Eb8D4b05DEdaA41D8525B6DD` |

## Contribution

Vane은 AI와 대규모 언어 모델을 누구나 쉽게 사용할 수 있어야 한다는 생각으로 만들어졌습니다. 버그를 발견하시거나 아이디어가 있다면 GitHub Issues를 통해 공유해 주세요. Vane에 기여하는 방법에 대한 자세한 내용은 [CONTRIBUTING.md](CONTRIBUTING.md) 파일을 읽어보시기 바랍니다.

## Help and Support

질문이나 피드백이 있으시면 언제든지 문의해 주세요. GitHub에 이슈를 생성하거나 Discord 서버에 참여하실 수 있습니다. 그곳에서 다른 사용자들과 연결되어 경험과 리뷰를 공유하고, 더 개인화된 도움을 받을 수 있습니다. Discord 서버에 참여하려면 [여기](https://discord.gg/EFwsmQDgAu)를 클릭하세요. 일반적인 지원 외의 사항은 Discord의 `itzcrazykns`로 연락해 주세요.

검색 경험을 향상시키기 위해 설계된 AI 기반 검색 엔진, Vane을 탐색해 주셔서 감사합니다. 저희는 Vane을 개선하고 기능을 확장하기 위해 끊임없이 노력하고 있습니다. Vane을 더욱 발전시키는 데 도움이 되는 여러분의 피드백과 기여를 소중히 생각합니다. 업데이트와 새로운 기능을 위해 계속 확인해 주세요!

Vane

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README