gpt4free

원클릭 설치 및 포터블 실행

런처 실행 후 설치 유형을 선택하기만 하면 Python과 g4f가 자동으로 구성되며, 별도의 시스템 변경 없이 자체 폴더 안에서 모든 것이 동작합니다.

웹 GUI와 REST API 동시 제공

설치 후 로컬 서버가 뜨면서 브라우저 기반 채팅 화면과 OpenAI 호환 API 엔드포인트가 함께 제공됩니다.

데스크톱 바로가기

설치 완료 시 ‘Start G4F Server’ 바로가기가 생성되어, 더블클릭 한 번으로 서버를 띄울 수 있습니다.

설치 유형 선택(Optimized / Full)

필수 기능만 담은 Optimized 모드(149 MB)와 마크다운 변환기·브라우저 자동화 등 부가 구성요소를 포함한 Full 모드(600 MB) 가운데 선택할 수 있습니다.

광범위한 윈도우 호환성

Windows Vista/7/8.1/10/11을 지원하며, 구버전에서는 TLS 한계를 안내하고 수동 설치 절차를 제공합니다.

설치 방법

1. GitHub 릴리스 페이지에서 g4f_launcher.exe(약 500 KB)를 내려받거나, winget으로 winget install –id gpt4free.g4fexe –exact 명령을 실행합니다.
2. 포터블 미리 설치 버전을 사용하려면 gpt4free_portable_preinstalled.zip(약 600 MB)을 내려받아 압축을 풀고 바로 실행할 수도 있습니다.
3. 런처를 실행한 뒤 Optimized 또는 Full 중 설치 유형을 선택하고 1~2분(Optimized 기준) 정도 기다립니다.

서버 시작

바탕화면의 ‘Start G4F Server’ 바로가기를 더블클릭하거나, 직접 명령으로 python-embedpython.exe -m g4f.cli api –port 8080을 실행해 서버를 띄울 수 있습니다. 기본 포트는 8080이며 다른 포트를 지정하려면 –port 8081처럼 인자를 바꿔 호출합니다.

접속 주소

• 웹 GUI: http://localhost:8080/chat/
• OpenAI 호환 API: http://localhost:8080/v1/
• 채팅 완성 API: http://localhost:8080/v1/chat/completions
• 모델 목록: http://localhost:8080/v1/models

API는 일반 HTTP 요청으로 호출할 수 있으며, 예시로 curl http://localhost:8080/v1/chat/completions -H “Content-Type: application/json” -d ‘{“model”:”gpt-4″,”messages”:[{“role”:”user”,”content”:”Hello!”}]}’ 형태의 호출이 문서에 안내되어 있습니다.

설치 방식은 어떤 차이가 있나요?

g4f_launcher.exe는 실행 시 Python과 g4f를 자동으로 받아 구성하며, gpt4free_portable_preinstalled.zip은 Python과 g4f가 이미 포함된 포터블 묶음입니다.

기본으로 열리는 화면은 무엇인가요?

설치가 완료되면 로컬 서버가 시작되고 브라우저가 http://localhost:8080/chat/ 으로 자동 이동합니다.

API는 OpenAI와 호환되나요?

http://localhost:8080/v1/ 경로가 OpenAI 호환 엔드포인트로 제공되며, 채팅 완성·모델 목록 API도 함께 노출됩니다.