> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orq.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Simple deployment pattern
> Implement simple deployment architecture for LLM applications. Quick-start pattern for straightforward AI integration with minimal configuration overhead.
## Objective
The Simple Deployment architecture provides the most straightforward way to integrate Orq.ai into your application as an AI Gateway. This pattern serves as the primary entry point for routing LLM calls through the Orq.ai platform, enabling you to benefit from unified routing, monitoring, and security features while maintaining a clean separation between your application logic and AI model configurations.
## Use Case
Simple Deployment is ideal for applications that need:
* **Single Model Integration**: Applications requiring one primary LLM interaction pattern.
* **Straightforward AI Features**: Chat interfaces, content generation, or text processing workflows.
* **Rapid Prototyping**: Quick integration for testing AI capabilities in existing systems.
* **Centralized Management**: Teams wanting to manage AI configurations outside of application code.
* **Standard LLM Operations**: Text completion, chat completion, or simple prompt-response patterns.
## Prerequisite
Before configuring a Simple Deployment, ensure you have:
* **Orq.ai Account**: Active workspace in the AI Studio.
* **API Access**: Valid API key from [Workspace Settings > API Keys](/docs/administer/api-keys).
* **Model Access**: At least one model enabled in the [AI Router](/docs/model-garden/overview), see [Using the AI Router](/docs/model-garden/using-ui).
## Configuring a Deployment
To create a [Deployment](/docs/deployments/overview), head to the AI Studio:
* Choose a [Project](/docs/projects/overview) and Folder and select the `+` button.
* Choose Deployment.
You should see a modal to configure your initial deployment where you can:
Then configure your Deployment Variant, using the [Prompt](/docs/prompts/overview) template, enter the messages that the model should reply to.
Multiple parameters are available for your model, to learn more, see [Model Parameters](/docs/prompts/creating#model-parameters).
Learn more about the possibilities of Prompts in Orq.ai, see [Creating a Prompt](/docs/prompts/creating).
Choose **Deploy** once ready, this will make your newly created [Deployment](/docs/deployments/overview) available through the API.
## Integrating with the SDK
Choose your preferred programming language and install the corresponding SDK:
```bash Bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
# pip
pip install orq-ai-sdk
```
```bash Bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
# npm
npm install @orq-ai/node
```
Get your integration ready by initializing the SDK as follows:
```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
import os
from orq_ai_sdk import Orq
client = Orq(
api_key=os.environ.get("ORQ_API_KEY", "__API_KEY__"),
environment="production",
identity_id="contact_x123x" # optional
)
```
```typescript Typescript theme={"theme":{"light":"github-light","dark":"github-dark"}}
const deployment = await client.deployments.invoke({
key: "myDeployment",
context: {
environments: []
},
metadata: {
"custom-field-name": "custom-metadata-value"
}
});
```
## Calling the Deployment
To call the [Deployment](/docs/deployments/overview) within your integration, use the following calls:
```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
generation = client.deployments.invoke(
key="myDeployment",
context={
"environments": []
},
metadata={
"custom-field-name": "custom-metadata-value"
}
)
print(generation.choices[0].message.content)
```
```typescript Typescript theme={"theme":{"light":"github-light","dark":"github-dark"}}
const deployment = await client.deployments.invoke({
key: "myDeployment",
context: {
environments: []
},
metadata: {
"custom-field-name": "custom-metadata-value"
}
});
```
## Viewing Logs
Going back to the [Deployment](/docs/deployments/overview) page, you can view the calls made through the previously created application. You can view details for a single log by clicking on a log line. This opens a panel containing all the details for the log, including context, requests, and parameters sent to your [Deployment](/docs/deployments/overview).
To learn more about logs see [Logs](/docs/observability/logs).
You completed basic common architecture for a Simple Deployment, explore more of our other Architectures to see more complex architectures.