Practical overview
When it fits
Use it when developing a Python application that needs Qianfan model access or when composing AppBuilder components and workflow stages into an AI or RAG application.
Who it is for
- Python developers building applications with models available through Baidu Qianfan.
- Teams assembling RAG applications from document-processing, embedding, retrieval and answer-generation components.
Documented uses
- Call a Qianfan model with a prompt template and chosen parameters.
- Build a RAG pipeline that parses and chunks documents, creates embeddings and retrieves relevant material for answer generation.
- Manage knowledge-base documents and chunks, or compose workflows using Message, Component and AgentRuntime abstractions.
- Connect an application to published AppBuilder applications and Baidu ecosystem components.
Requirements & limits
The Python installation instructions require Python 3.9 or later. The README quick start uses a personal token and a model the developer has permission to access through Qianfan. Certain capability-component calls require claiming a free trial quota. The repository is public under Apache-2.0.
- The SDK is a client for the Baidu Qianfan AppBuilder platform, not a standalone model host.
- The documented Python operating systems are Linux, Windows and macOS.
- The README describes more than 40 Baidu-ecosystem components, with a free-trial-quota prerequisite for component calls.
- AgentRuntime deployment options described in the repository include Flask with gunicorn and a Chainlit conversation interface.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install the AppBuilder SDK and invoke a Qianfan model
Install the Python SDK and use its Playground component to request a model response with a prompt template.
Before you start
- Python 3.9 or later.
- An AppBuilder personal token, which the example places in the APPBUILDER_TOKEN environment variable.
- Access to a model on the Baidu Qianfan large-model platform.
Steps
Install or upgrade the SDK with the command below.
python3 -m pip install --upgrade appbuilder-sdkSet
APPBUILDER_TOKENto your personal token in the Python environment.Create an
appbuilder.Messagewith values for the prompt template, then initializeappbuilder.Playgroundwith the template and an available model.Call the Playground with the message and
stream=True; iterate overoutput.contentto display streamed response content. The example also printsoutput.model_dump_json(indent=4)after streaming.
Expected outcome
The example displays streamed model response text and then prints the complete response object, including token-usage information.
Guide limitations
- The SDK requires Python 3.9 or later.
- The example requires a personal token and a model the user is permitted to call.
- The README's displayed model name is an example; model availability and permissions are not established for every account.
Call the Baidu Search-enhanced RAG component
Use the SDK's RAG with Baidu Search Pro component to submit a message with an instruction and print its result.
Before you start
- Python 3.9 or later with the AppBuilder SDK installed.
- An AppBuilder personal token set in
APPBUILDER_TOKEN. - The README says to obtain free trial quota before calling capability components.
Steps
Set
APPBUILDER_TOKENto your personal token in the Python environment.Initialize
appbuilder.RagWithBaiduSearchProwith a model name.Wrap the query in
appbuilder.Messageand call the component'srunmethod with that message and an instruction wrapped inappbuilder.Message.Print the returned result using
result.model_dump_json(indent=4).
Expected outcome
The example prints a structured result containing an answer to the submitted query.
Guide limitations
- The README states that capability components require applying for free trial quota before use.
- The model shown is an example; the source does not establish that it is available to every user.
- The example describes the component as combining Baidu Search technology with ERNIE semantic understanding; results depend on the service and model.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 9 October 2026
- Original website title
- baidubce/app-builder · Official homepage title · retained in its source language

