StarVector: 이미지와 텍스트에서 SVG 벡터 그래픽을 생성하기 위한 기본 모델입니다.

1.6K 00

일반 소개

StarVector는 이미지와 텍스트를 확장 가능한 벡터 그래픽(SVG)으로 변환하기 위해 Juan A. Rodriguez와 같은 개발자가 만든 오픈 소스 프로젝트입니다. 이 도구는 이미지 콘텐츠와 텍스트 지침을 이해하는 시각적 언어 모델을 사용하여 고품질의 SVG 코드를 생성합니다. 핵심 기능은 벡터화 과정을 아이콘, 기술 다이어그램, 로고 등에 적합한 코드 생성 작업으로 전환하는 것입니다. StarVector는 2백만 개 이상의 실제 SVG 샘플이 포함된 SVG-Stack 데이터 세트에서 학습되어 정확하고 다양한 결과를 보장합니다. 이 프로젝트는 현재 ServiceNow Research와 Mila 등의 지원을 받고 있으며, 2025년 3월에 마지막으로 업데이트되었습니다.

기능 목록

이미지에서 SVG 생성: 픽셀 이미지를 입력하고 해당 벡터 그래픽 코드를 생성합니다.
텍스트에서 SVG 생성: 텍스트 설명을 기반으로 새로운 SVG 그래픽을 생성합니다.
다양한 그래픽 요소 지원: 경로, 타원, 다각형 및 텍스트와 같은 SVG 기본 요소.
고정밀 벡터화: 결과 SVG는 디테일이 유지되며 확대 사용에 적합합니다.
오픈 소스 및 무료: 코드가 공개되어 있어 사용자가 자유롭게 다운로드하고 수정할 수 있습니다.

도움말 사용

스타벡터를 사용하려면 코드 기반 프로젝트이므로 약간의 기술적 기반이 필요합니다. 다음은 사용자가 빠르게 시작하는 데 도움이 되는 자세한 설치 및 운영 단계입니다.

설치 프로세스

환경 준비하기
- 컴퓨터에 파이썬 3.11.3이 설치되어 있는지 확인합니다. 다음 명령으로 버전을 확인할 수 있습니다:
```
python --version
```
- 그렇지 않은 경우 https://www.python.org 에서 다운로드하여 설치하세요.
- GitHub에서 코드를 다운로드하려면 Git을 설치합니다. https://git-scm.com 에서 다운로드합니다.
가상 환경 만들기
- 터미널을 열고 다음 명령을 입력하여 새 Python 환경을 만듭니다:
```
conda create -n starvector python=3.11.3 -y
```
- 환경을 활성화합니다:
```
conda activate starvector
```
스타벡터 코드 다운로드
- 터미널에 입력합니다:
```
git clone https://github.com/joanrod/star-vector.git
```
- 프로젝트 폴더로 이동합니다:
```
cd star-vector
```
종속성 설치
- pip를 업데이트하고 필요한 라이브러리를 설치합니다:
```
pip install --upgrade pip
pip install -e .
```
- 스타벡터를 실행하는 데 필요한 모든 Python 패키지가 설치됩니다.
환경 변수 설정
- 모델을 학습시키거나 고급 기능을 사용하려면 다음 변수를 구성해야 합니다:
```
export HF_HOME=<模型存储路径>
export HF_TOKEN=<你的 Hugging Face 令牌>
export WANDB_API_KEY=<你的 Weights & Biases 令牌>
export OUTPUT_DIR=<输出路径>
```
- 터미널에 입력하거나 환경 설정 파일에 기록할 수 있습니다.

사용법

이미지에서 SVG 생성

이미지 준비하기
- 아이콘, 로고 또는 기술 다이어그램 이미지를 선택하여 일반적인 형식(예: PNG 또는 JPG)으로 저장합니다.
- 참고: 스타벡터는 자연 풍경이나 복잡한 일러스트레이션 작업에는 적합하지 않으므로 간단한 그래픽을 사용하는 것이 좋습니다.

실행 중인 코드

이미지를 프로젝트 폴더에 넣고 터미널에 입력합니다:

python scripts/image_to_svg.py --input <图像路径> --output <输出SVG路径>

예를 들어

python scripts/image_to_svg.py --input icon.png --output icon.svg

결과 보기
- 생성된 SVG 파일은 지정된 경로에 저장됩니다. 브라우저 또는 벡터 그래픽 소프트웨어(예: Inkscape)로 열어 검사할 수 있습니다.

텍스트에서 SVG 생성

텍스트 명령 입력
- 터미널을 열고 텍스트 생성 스크립트를 실행합니다:
```
python scripts/text_to_svg.py --text "一个红色圆形" --output circle.svg
```
- 예를 들어 '검은색 다섯 개의 별' 또는 '파란색 직사각형 상자'와 같이 최대한 구체적으로 설명하세요.
출력 확인
- 생성된 SVG 파일은 지정된 경로에 저장되며, 해당 파일을 열어 기대에 부합하는지 확인합니다.

고급 기능: 교육 모델

모델을 직접 학습시키려면 SVG-Stack 데이터 세트를 사용할 수 있습니다.
트레이닝 명령(예: StarVector-1B)을 실행합니다:

deepspeed scripts/train.py --data_path <SVG-Stack路径> --output_dir <输出路径>

참고: 교육에는 더 높은 사양의 컴퓨터가 필요하며 GPU 지원이 필요할 수 있습니다.

운영 기술

테스트 중 구성 요소 조정생성된 결과가 만족스럽지 않은 경우 입력 이미지가 너무 복잡하거나 텍스트 설명이 명확하지 않은지 확인하세요.
사용자 지정정확도를 높이기 위해 샘플 수를 늘리는 등 코드에서 매개변수를 조정할 수 있습니다.
문서 보기프로젝트의 루트 디렉터리에 있는 README.md 파일에 더 많은 지침이 있으므로 주의 깊게 읽어보는 것이 좋습니다.

이 단계를 통해 이미지나 텍스트에서 SVG 파일을 쉽게 생성할 수 있습니다. 설치 과정은 약 10~20분 정도 소요되며, 사용하기 쉬워 기본적인 프로그래밍 기술을 갖춘 디자이너나 개발자에게 적합합니다.

애플리케이션 시나리오

아이콘 디자인
디자이너는 스타벡터를 사용하여 스케치를 벡터 아이콘으로 빠르게 변환하여 수동 추적 시간을 절약할 수 있습니다.
기술 문서
엔지니어는 이를 사용하여 문서나 웹 페이지에 직접 삽입할 수 있는 다이어그램이나 순서도를 생성할 수 있습니다.
교육용 데모
교사는 텍스트 설명이 포함된 교육용 그래픽을 생성하여 개념을 시각적으로 보여줄 수 있습니다.
웹 개발
개발자는 이를 사용하여 확대/축소 가능한 웹 요소를 빠르게 만들고 로딩 속도를 높일 수 있습니다.

QA

스타벡터가 사진을 처리할 수 있나요?
불가능합니다. 아이콘, 로고 및 기술 다이어그램용으로 설계되었으며 자연스러운 이미지나 복잡한 일러스트레이션에는 적합하지 않습니다.
결제해야 하나요?
아니요. StarVector는 오픈 소스 프로젝트이며 코드와 기본 기능은 무료로 사용할 수 있습니다.
생성된 SVG를 편집할 수 있나요?
예. 생성된 SVG는 표준 형식이며 Inkscape 또는 Illustrator에서 편집할 수 있습니다.
설치에 실패하면 어떻게 하나요?
Python 버전이 올바른지 확인하고, 네트워크 연결이 제대로 작동하는지 확인하거나 터미널 오류 메시지를 찾아보세요.