Skip to main content

DSL for Generative AI Prototyping

Project description

QType

QType is a domain-specific language (DSL) for rapid prototyping of AI applications.
It is designed to help developers define modular, composable AI systems using a structured YAML-based specification. QType supports models, prompts, tools, retrievers, and flow orchestration, and is extensible for code generation or live interpretation.


🚀 Quick Start

Install QType:

pip install qtype[interpreter]

Create a file hello_world.qtype.yaml that answers a question:

id: hello_world
flows:
  - id: chat_example
    description: A simple chat flow with OpenAI
    mode: Chat
    steps:
      - id: llm_inference_step
        model: 
          id: gpt-4
          provider: openai
          auth: 
            id: openai_auth
            type: api_key
            api_key: ${OPENAI_KEY}
        system_message: |
          You are a helpful assistant.
        inputs:
          - id: user_message
            type: ChatMessage
        outputs:
          - id: response
            type: ChatMessage

Put your openai api key into your .env file:

echo "OPENAI_KEY=sk...." >> .env

Validate it's semantic correctness:

qtype validate hello_world.qtype.yaml 

You should see:

INFO: ✅ Schema validation successful.
INFO: ✅ Model validation successful.
INFO: ✅ Language validation successful
INFO: ✅ Semantic validation successful

Launch the interpreter:

qtype serve hello_world.qtype.yaml`

And go to http://localhost:8000/ui to see the user interface for your application:

Example UI


See the full docs for more examples and guides.

🤝 Contributing

Contributions welcome! Please follow the instructions in the contribution guide.

📄 License

This project is licensed under the MIT License.
See the LICENSE file for details.


🧠 Philosophy

QType is built around modularity, traceability, and rapid iteration. It aims to empower developers to quickly scaffold ideas into usable AI applications without sacrificing maintainability or control.

Stay tuned for upcoming features like:

  • Integrated OpenTelemetry tracing
  • Validation via LLM-as-a-judge
  • UI hinting via input display types
  • Flow state switching and conditional routing

Happy hacking with QType! 🛠️

Generate JSON Schema Publish to PyPI

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qtype-0.1.7.tar.gz (1.3 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

qtype-0.1.7-py3-none-any.whl (1.3 MB view details)

Uploaded Python 3

File details

Details for the file qtype-0.1.7.tar.gz.

File metadata

  • Download URL: qtype-0.1.7.tar.gz
  • Upload date:
  • Size: 1.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for qtype-0.1.7.tar.gz
Algorithm Hash digest
SHA256 8660e224d6748b1731cf680fe6b40d8442c3a3315f9730e51b2c9682b4697317
MD5 cdc9c4602bda3e58f4c40c5b88c267da
BLAKE2b-256 50573dc7b410bc0fb584b6d8ab4fb248e38f6e5466a2a52d535ef7229e1ec9f9

See more details on using hashes here.

Provenance

The following attestation bundles were made for qtype-0.1.7.tar.gz:

Publisher: publish-pypi.yml on bazaarvoice/qtype

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file qtype-0.1.7-py3-none-any.whl.

File metadata

  • Download URL: qtype-0.1.7-py3-none-any.whl
  • Upload date:
  • Size: 1.3 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for qtype-0.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 2d738ce5bb59d8f1a3947c6b9ab542d020e6f929ded46e00072f739796b959f0
MD5 5d25035690044594a557b847cec0b53a
BLAKE2b-256 0d3ad24200380456ed5621b65067baa6d61cf613dbd46b85951c1c058c4c5398

See more details on using hashes here.

Provenance

The following attestation bundles were made for qtype-0.1.7-py3-none-any.whl:

Publisher: publish-pypi.yml on bazaarvoice/qtype

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page