1# Cosmos DB Recipe — Python — REFERENCE ONLY
2 
3## Cosmos SDK Setup
4 
5### Requirements
6 
7Add to `requirements.txt`:
8 
9```
10azure-cosmos>=4.7
11azure-identity
12```
13 
14### Database Module
15 
16Create `cosmos_client.py`:
17 
18```python
19import os
20from azure.cosmos import CosmosClient
21from azure.identity import DefaultAzureCredential
22 
23credential = DefaultAzureCredential()
24client = CosmosClient(os.environ["COSMOS_ENDPOINT"], credential)
25database = client.get_database_client(os.environ["COSMOS_DATABASE_NAME"])
26container = database.get_container_client(os.environ["COSMOS_CONTAINER_NAME"])
27```
28 
29### CRUD Endpoints
30 
31Add to `main.py`:
32 
33```python
34from cosmos_client import container
35 
36@app.get("/api/items")
37async def list_items():
38    items = list(container.read_all_items())
39    return items
40 
41@app.post("/api/items", status_code=201)
42async def create_item(item: dict):
43    return container.create_item(body=item)
44```
45 
46## Files to Modify
47 
48| File | Action |
49|------|--------|
50| `cosmos_client.py` | Create — Cosmos client + container reference |
51| `main.py` | Modify — add CRUD endpoints |
52| `requirements.txt` | Modify — add azure-cosmos, azure-identity |
53