BillyGPT - GitLite

KO | EN

gitlite — search

#javascript #hacktoberfest #react #typescript #llm #golang #rust #deep-learning #docker #macos #nodejs #security #mcp #openai

BillyGPT

(★ 390)

Maintenance-mode desktop ChatGPT client built with Flet, kept as a small open-source archive with smoke and startup checks.

파일 탐색기

최종 버전 다운로드 (.zip)

- - smoke.yml
- font.ttf
- function_preview.png
- check_frontend_startup.py
- check_release_files.py
- smoke_check.py
.gitignore
api_key_store.py
chat_store.py
LICENSE
main.py
paths.py
prompt_engineering.py
README.md
requirements-lock.txt
requirements.txt

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/B1lli/BillyGPT

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd BillyGPT

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Python

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Python 3 설치 시 'Add Python to PATH' 옵션을 꼭 체크하세요 (Windows).

pip install -r requirements.txt

requirements.txt 등에 명시된 파이썬 라이브러리를 설치합니다.

pip install -r requirements-lock.txt

requirements.txt 등에 명시된 파이썬 라이브러리를 설치합니다.

✅ 에러 메시지 없이 실행되고 터미널에 안내 문구가 출력되면 정상입니다.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# BillyGPT

> Maintenance-mode project from March 2023. BillyGPT is kept public as an early ChatGPT API desktop client with reproducible setup, safer local key handling, and a small smoke-check path for future maintenance.

BillyGPT was a free, open-source, cross-platform ChatGPT desktop client built around prompt optimization, local chat history, editable conversations, and bring-your-own API key usage.

![BillyGPT desktop preview](https://raw.githubusercontent.com/B1lli/BillyGPT/main/pic/function_preview.png)

## Status

- Maintenance-mode legacy project.
- Built for the early ChatGPT API era in 2023.
- Uses the OpenAI Python SDK version pinned in `requirements.txt`.
- Kept as a stable historical desktop-client implementation.

## Features

- Local chat history storage.
- Prompt-optimization mode for more structured answers.
- Long conversation summarization.
- Import and export of chat history.
- Editable message role and content.
- Custom font selection.
- Bring-your-own OpenAI API key.

## Usage

Python 3.10 is the verified runtime for this legacy dependency set.

Install dependencies and run:

```bash
pip install -r requirements.txt
python main.py
```

For a fully pinned environment, use:

```bash
pip install -r requirements-lock.txt
```

For safer local usage, prefer setting your key through the environment:

```bash
export OPENAI_API_KEY="your-key-here"
python main.py
```

The settings dialog keeps an entered key for the current process only. For repeat use, set `OPENAI_API_KEY` in your shell or local environment manager.

## Smoke Check

Run this after installing dependencies:

```bash
python scripts/smoke_check.py
```

The smoke check verifies imports, API key loading, and chat persistence helpers without opening the UI.

To check that the repository's tracked files are sufficient for a fresh clone, run:

```bash
python scripts/check_release_files.py
```

For a browser-rendered startup check, run this with Chrome or Chromium installed:

```bash
python scripts/check_frontend_startup.py
```

The startup check runs a local Flet web server and a headless browser. It does not open the desktop app window or a visible browser window.

## Troubleshooting

Install dependencies before running the checks:

```bash
pip install -r requirements.txt
```

If the front-end startup check cannot find Chrome, set `CHROME_BIN` to a local Chrome or Chromium executable. The script intentionally fails in environments without a headless browser instead of opening the desktop UI.

## Security Note

Never commit API keys or local chat logs.

This repository ignores legacy `APIKEY.txt` files and chat logs, but if you fork or copy the project, check your changes before pushing:

```bash
git status --short
git diff --cached
```

If a key was ever committed, delete the key in the provider dashboard and create a new one. Removing it from Git history is not enough.

## Framework

Built with Flet, targeting desktop and cross-platform experiments.

## License

MIT.

## Historical Context

BillyGPT was made during the first public ChatGPT API wave. Its value today is mostly historical: it captured early product ideas around prompt optimization, local control, editable conversations, and personal AI clients.