Question 1

Leon AI에서 Google Cloud TTS/STT를 사용할 때 오디오 또는 비디오 오류를 수정하는 방법?

Accepted Answer

`.env` 파일에 제공자 이름이 잘못되면 오디오/비디오 오류가 발생합니다. 명시적으로 설정하세요:

```bash
LEON_TTS_PROVIDER=google-cloud-tts
LEON_STT_PROVIDER=google-cloud-stt
```

또한 `GOOGLE_APPLICATION_CREDENTIALS`가 서비스 계정 키 파일을 가리키는지 확인하세요.

Question 2

Windows에서 Leon을 설치할 때 발생하는 npm 'ENOENT package.json', 'missing script: postinstall' 및 'No module named tinydb' 오류를 해결하는 방법

Accepted Answer

이 오류들은 Leon의 실제 `package.json`이 포함되지 않은 폴더에서 npm을 실행하고 있거나, 의존성 설치를 건너뛰었음을 의미합니다. `npm init`을 실행하면 빈 패키지만 생성될 뿐 Leon의 `postinstall` 스크립트는 추가되지 않습니다.

1. 최신 Leon 버전을 다시 다운로드/클론하고 루트 폴더를 엽니다:
```sh
cd A:\Lexa\Lexa-Test
git clone https://github.com/leon-ai/leon.git leon-latest
cd leon-latest
```
2. Leon의 `package.json`이 존재하는지 확인합니다:
```sh
dir package.json
```
3. 프로젝트 루트에서 의존성을 설치합니다. 이렇게 하면 Leon의 `postinstall`도 실행되고 Pipenv에 필요한 Python 의존성도 설치됩니다:
```sh
npm install
```
4. 검사를 다시 실행합니다:
```sh
npm run check
```

`npm init`으로 생성된 빈 `package.json`은 사용하지 마세요. Leon의 파일을 대체했다면 삭제하거나 다시 클론하세요. `tinydb`가 여전히 누락되어 있다면 Python 의존성을 직접 설치하세요:
```sh
cd bridges\python
pipenv sync
cd ..\..
npm run check
```
`Pipfile.lock`이 없다면 `pipenv sync` 대신 `pipenv install`을 사용하세요.

Question 3

Windows 10에서 Leon AI를 설치할 때 'TypeError: Invalid Version: 3.7.6rc1' 오류를 해결하는 방법은?

Accepted Answer

이 오류는 semver npm 패키지가 Python의 릴리스 후보 버전 문자열(예: `3.7.6rc1`)을 구문 분석하지 못하기 때문에 발생합니다. 해결 방법:

1. 안정적인 Python 릴리스(예: 3.7.6 또는 3.8.1)를 설치하고 pipenv에서 이를 사용하도록 합니다.
2. 또는 이 문제가 수정되었을 수 있는 `develop` 브랜치로 전환합니다:
```bash
git checkout develop
npm install
npm run check
```
3. 로컬 설정 없이 빠르게 시작하려면 Gitpod를 사용하세요:
[https://gitpod.io/#https://github.com/leon-ai/leon](https://gitpod.io/#https://github.com/leon-ai/leon)

Question 4

Leon의 /download 모델 명령에서 패스 트래버설 취약점(임의 파일 쓰기)을 수정하는 방법은?

Accepted Answer

이 취약점은 `server/src/built-in-command/commands/download-command/download-command.ts`의 `getModelFileNameFromURL()`에 있습니다. 이 함수는 `decodeURIComponent(path.basename(parsedURL.pathname))`를 실행하므로, `basename`은 퍼센트 인코딩된 문자열만 보게 되어 `%2f`와 `..` 같은 인코딩된 구분자를 놓치게 됩니다. basename을 추출하기 전에 디코딩하고 디렉터리 참조를 제거하는 방식으로 패치하세요. 예: `const fileName = path.basename(decodeURIComponent(parsedURL.pathname))`. 이상적으로는 결과를 화이트리스트(예: `/^[a-zA-Z0-9._-]+$/`)로 검증하고, `path.resolve`를 사용해 최종 대상이 models 디렉터리 내부에 머무는지 확인해야 합니다. 수정된 릴리스로 업그레이드하기 전까지는: (1) `/download model <url>` 명령이 공격 표면이므로 Leon 서버를 신뢰할 수 없는 사용자/네트워크에 절대 노출하지 마세요. (2) 신뢰할 수 있는 모델 URL만 해당 명령에 전달하세요. (3) 임의의 파일 쓰기와 자동 상위 디렉터리 생성(`mkdir recursive`)이 제한되도록 낮은 권한의 사용자로, 또는 읽기 전용/제한된 파일시스템을 갖는 컨테이너에서 Leon을 실행하세요.

Leon

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트