PromptForge

Генератор system-промтов для LLM-агентов с экспортом в JSON для API

English | Русский

PromptForge — инструмент для создания, валидации и экспорта system-промтов LLM-агентов в готовые JSON-payload для API (OpenAI, Anthropic, универсальный формат).

Ключевые возможности

• 🎯 Интерактивный мастер — пошаговое создание конфигурации агента
• 🔒 Детерминированный рендер — одинаковый конфиг → одинаковый sha256 и версия промта
• ✅ Валидация конфигурации до генерации
• 🔧 Подстановка переменных {{key}} в тексте промта
• 📦 Три формата экспорта: OpenAI, Anthropic, универсальный raw
• 💬 Few-shot примеры — inline в system-промт или отдельными сообщениями
• 🛡️ Атомарная запись файлов
• 🎓 Интеграция с Django через management command

Установка

pip install promptforge

# С дополнительными зависимостями
pip install promptforge[yaml]       # поддержка YAML-конфигов
pip install promptforge[tokens]     # точная оценка токенов через tiktoken
pip install promptforge[all]        # все опциональные зависимости

Быстрый старт

# Создать конфигурацию агента (интерактивный мастер)
promptforge init -o agent.config.json

# Проверить конфигурацию
promptforge validate -c agent.config.json

# Посмотреть сгенерированный system-промт
promptforge preview -c agent.config.json

# Собрать JSON-payload для OpenAI
promptforge build -c agent.config.json -f openai -o build/agent.json

# Собрать JSON-payload для Anthropic
promptforge build -c agent.config.json -f anthropic -o build/agent.claude.json

Использование в коде

from promptforge import AgentConfig, PromptBuilder, export
from openai import OpenAI

# Загрузить конфигурацию
config = AgentConfig.from_file("agent.config.json")

# Собрать промт с подстановкой переменных
built = PromptBuilder(config, variables={"django_version": "5.1"}).build()

# Экспортировать в формат OpenAI
payload = export(built, "openai")

# Использовать с API
response = OpenAI().chat.completions.create(**payload)
print(response.choices[0].message.content)

Цитирование

Если вы используете PromptForge в научной работе или проекте, будем признательны за ссылку:

@software{promptforge2026,
  author = {Your Name},
  title = {PromptForge: System Prompt Generator for LLM Agents},
  year = {2026},
  publisher = {PyPI},
  url = {https://pypi.org/project/promptforge/},
  version = {1.0.0}
}

Лицензия

Проект распространяется под лицензией MIT.

Copyright: Copyright (c) 2026 Alex Jurow (mandalay-rp)

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.