Python client for interacting with the GPT Trainer API.
Project description
GPT Trainer API Python Client
A Python client library for interacting with the GPT Trainer API. This library provides an easy-to-use interface for managing chatbots, agents, sessions, messages, and data sources.
Features
- Chatbot Management: Create, update, list, and delete chatbots.
- Agent Management: Manage agents associated with chatbots.
- Session Management: Create and manage chatbot sessions.
- Message Management: Retrieve and manage messages within sessions.
- Data Source Management: Upload, update, and delete chatbot data sources.
Installation
Install the library via pip:
pip install gpt-trainer-api
Alternatively, if you're developing locally, clone this repository and install it:
git clone https://github.com/Tahir-Siddique/gpt-trainer-api.git
cd gpt-trainer-api
pip install .
Usage
Initialize the API
from gpt_trainer.api import GPTTrainerAPI
# Initialize the GPT Trainer API client
api = GPTTrainerAPI(token="<your-api-token>")
Chatbot API
List all chatbots
chatbots = api.chatbot.get_chatbots()
for chatbot in chatbots:
print(chatbot.name, chatbot.uuid)
Create a chatbot
data = {
"name": "My New Chatbot",
"visibility": "private",
"rate_limit": [20, 240],
"rate_limit_message": "Too many messages. Try again later.",
"show_citations": True,
}
new_chatbot = api.chatbot.create_chatbot(data)
print(new_chatbot.uuid, new_chatbot.name)
Agent API
List all agents for a chatbot
chatbot_uuid = "<chatbot-uuid>"
agents = api.agent.get_agents(chatbot_uuid)
for agent in agents:
print(agent.name, agent.type)
Create an agent
data = {
"name": "Agent 1",
"description": "Handles FAQs",
"prompt": "Answer all FAQs concisely.",
"type": "user-facing",
"enabled": True,
}
new_agent = api.agent.create_agent(chatbot_uuid, data)
print(new_agent.uuid, new_agent.name)
Session API
Create a new session
new_session = api.session.create_session(chatbot_uuid)
print(new_session.uuid, new_session.created_at)
List sessions
sessions = api.session.list_sessions(chatbot_uuid)
for session in sessions:
print(session.uuid, session.meta)
Message API
List messages in a session
session_uuid = "<session-uuid>"
messages = api.message.list_messages(session_uuid)
for message in messages:
print(message.query, message.response)
Data Source API
List all data sources for a chatbot
sources = api.data_source.list_sources(chatbot_uuid)
for source in sources:
print(source.file_name, source.status)
Upload a file as a data source
file_path = "/path/to/your/file.txt"
new_source = api.data_source.upload_file(chatbot_uuid, file_path)
print(new_source.uuid, new_source.title)
Requirements
- Python >= 3.7
requestslibrary
Contributing
- Fork the repository.
- Create a feature branch.
- Commit your changes.
- Push to your branch.
- Submit a pull request.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Support
If you encounter any issues or have questions, please open an issue in the GitHub repository.
Authors
- Tahir Siddique - Python Developer - Tahir Siddique
Key Sections
- Features:
- Highlights what the library can do.
- Installation:
- Instructions for installing the package.
- Usage:
- Code examples for common operations.
- Requirements:
- Dependencies for the library.
- Contributing:
- Instructions for contributing to the project.
- License:
- Licensing information.
- Support:
- Instructions for getting help or reporting issues.
- Authors:
- Credits to the creator(s).
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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file gpt_trainer_api-0.2.0.tar.gz.
File metadata
- Download URL: gpt_trainer_api-0.2.0.tar.gz
- Upload date:
- Size: 12.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cf1287a18d37a7cc006e6735d8a36e6d7525d14dc6452974df3831732981d5ae
|
|
| MD5 |
489dea3e6cc53e9111d778a80026ebf5
|
|
| BLAKE2b-256 |
0fdb516ed542bdb25867c4833019bde3a90e8c2a56320f5ce99f234e88932084
|
File details
Details for the file gpt_trainer_api-0.2.0-py3-none-any.whl.
File metadata
- Download URL: gpt_trainer_api-0.2.0-py3-none-any.whl
- Upload date:
- Size: 18.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6f43800e5e2e17d93670fe92979b0fd1cf96c8e6c2e940dddde449c8b04f46a4
|
|
| MD5 |
61d9faca176007d2bb86aa49985a4eaa
|
|
| BLAKE2b-256 |
ac38afd6fe4b1d407a930b85d5d039acd13a4367b2a3bc2430452788270532b8
|