Repolode
knowsuchagency

knowsuchagency/promptic

LiteLLM 기반의 경량 Python 데코레이터 라이브러리로, docstring을 LLM 프롬프트로 바꾸고 Pydantic 출력, 툴 호출, 스트리밍, 메모리를 지원합니다.

스타
272
포크
24
열린 이슈
0
마지막 커밋
26일 전

어떤 프로젝트인가요?

Promptic은 LLM 애플리케이션을 만들기 위한 소규모 Python 라이브러리입니다. 함수에 @llm을 적용하면 docstring이 프롬프트 템플릿이 되고, 함수 인수로 내용을 채웁니다. 호출 결과로 모델의 응답이 바로 반환되므로, 별도로 요청을 처리하지 않고도 함수를 프롬프트처럼 사용할 수 있습니다.

내부적으로 LiteLLM을 사용하므로 모델 이름만 바꾸면 같은 코드로 OpenAI, Anthropic, Gemini, Azure 등의 제공자를 이용할 수 있습니다. 반환 타입 어노테이션으로 Pydantic 모델이나 JSON Schema 딕셔너리를 지정할 수 있으며, 응답은 해당 타입에 맞게 검증됩니다. @llm.tool을 적용한 함수는 모델이 호출할 수 있는 툴로 제공됩니다.

ImageBytes 타입으로 이미지 입력을 처리하고, 응답 스트리밍, State 클래스를 연결해 선택적으로 사용할 수 있는 대화 메모리, Anthropic 프롬프트 캐싱 제어, Weave 트레이싱 연동도 지원합니다. 라이브러리를 얇게 유지하도록 설계해 하위 제공자 SDK에도 계속 접근할 수 있습니다.

핵심 기능

  • 01@llm 데코레이터를 통해 함수 docstring을 프롬프트 템플릿으로 변환합니다.
  • 02Pydantic 모델 또는 JSON Schema에 맞춰 구조화된 출력을 검증합니다.
  • 03@llm.tool로 등록한 함수를 통한 툴 호출을 지원합니다.
  • 04응답을 스트리밍하고 ImageBytes 타입으로 이미지 입력을 받습니다.
  • 05커스터마이즈 가능한 State 클래스를 사용해 대화 메모리를 선택적으로 지원합니다.

활용 사례

  • 요청 처리용 보일러플레이트 코드를 작성하지 않고 Python에서 LLM 기능을 빠르게 프로토타이핑합니다.
  • 텍스트나 이미지에서 타입이 지정된 데이터를 추출해 Pydantic 객체로 만듭니다.
  • Python 함수를 툴로 호출하는 간단한 챗봇이나 에이전트를 구축합니다.
  • 애플리케이션 코드를 다시 작성하지 않고 LLM 제공자를 전환합니다.

빠른 시작

  1. 1

    PyPI에서 promptic을 설치합니다

    pip install promptic
  2. 2

    LLM 제공업체의 API 키를 환경 변수로 설정합니다(OpenAI의 경우 예시)

    export OPENAI_API_KEY=sk-...
  3. 3

    함수에 @llm 데코레이터를 적용하고 docstring을 프롬프트로 사용해 호출합니다

사용 전 알아둘 점

  • OpenAI 또는 Anthropic과 같은 LLM 제공업체의 API 키나 호환 가능한 모델 설정이 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

promptic은(는) 무엇인가요?
LiteLLM 기반의 경량 Python 데코레이터 라이브러리로, docstring을 LLM 프롬프트로 바꾸고 Pydantic 출력, 툴 호출, 스트리밍, 메모리를 지원합니다. Promptic은 LLM 애플리케이션을 만들기 위한 소규모 Python 라이브러리입니다. 함수에 @llm을 적용하면 docstring이 프롬프트 템플릿이 되고, 함수 인수로 내용을 채웁니다. 호출 결과로 모델의 응답이 바로 반환되므로, 별도로 요청을 처리하지 않고도 함수를 프롬프트처럼 사용할 수 있습니다.
promptic은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
promptic은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
promptic은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. promptic의 마지막 커밋은 2026년 10월 12일입니다.
promptic은(는) 어디에 사용할 수 있나요?
요청 처리용 보일러플레이트 코드를 작성하지 않고 Python에서 LLM 기능을 빠르게 프로토타이핑합니다. 텍스트나 이미지에서 타입이 지정된 데이터를 추출해 Pydantic 객체로 만듭니다. Python 함수를 툴로 호출하는 간단한 챗봇이나 에이전트를 구축합니다. 애플리케이션 코드를 다시 작성하지 않고 LLM 제공자를 전환합니다.
promptic는 어떻게 설치하나요?
PyPI에서 promptic을 설치합니다: pip install promptic LLM 제공업체의 API 키를 환경 변수로 설정합니다(OpenAI의 경우 예시): export OPENAI_API_KEY=sk-... 함수에 @llm 데코레이터를 적용하고 docstring을 프롬프트로 사용해 호출합니다
promptic은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/knowsuchagency/promptic

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트