CLOVA Studio¶

Community Contribution

This is a community-maintained package that is not owned or supported by the Strands team. Validate and review the package before using it in your project.

Have your own integration? We'd love to add it here too!

CLOVA Studio is Naver Cloud Platform's AI service that provides large language models optimized for Korean language processing. The strands-clova package (GitHub) provides a community-maintained integration for the Strands Agents SDK, enabling seamless use of CLOVA Studio's Korean-optimized AI models.

Installation¶

CLOVA Studio integration is available as a separate community package:

pip install strands-agents strands-clova

Usage¶

After installing strands-clova, you can import and initialize the CLOVA Studio provider:

from strands import Agent
from strands_clova import ClovaModel

model = ClovaModel(
    api_key="your-clova-api-key",  # or set CLOVA_API_KEY env var
    model="HCX-005",
    temperature=0.7,
    max_tokens=2048
)

agent = Agent(model=model)
response = await agent.invoke_async("안녕하세요! 오늘 날씨가 어떤가요?")
print(response.message)

Configuration¶

Environment Variables¶

export CLOVA_API_KEY="your-api-key"
export CLOVA_REQUEST_ID="optional-request-id"  # For request tracking

Model Configuration¶

The supported configurations are:

Parameter	Description	Example	Default
`model`	Model ID	`HCX-005`	`HCX-005`
`temperature`	Sampling temperature (0.0-1.0)	`0.7`	`0.7`
`max_tokens`	Maximum tokens to generate	`4096`	`2048`
`top_p`	Nucleus sampling parameter	`0.8`	`0.8`
`top_k`	Top-k sampling parameter	`0`	`0`
`repeat_penalty`	Repetition penalty	`1.1`	`1.1`
`stop`	Stop sequences	`["\\n\\n"]`	`[]`

Advanced Features¶

Korean Language Optimization¶

CLOVA Studio excels at Korean language tasks:

# Korean customer support bot
model = ClovaModel(api_key="your-api-key", temperature=0.3)
agent = Agent(
    model=model,
    system_prompt="당신은 친절한 고객 서비스 상담원입니다."
)

response = await agent.invoke_async("제품 반품 절차를 알려주세요")

Bilingual Capabilities¶

Handle both Korean and English seamlessly:

# Process Korean document and get English summary
response = await agent.invoke_async(
    "다음 한국어 문서를 영어로 요약해주세요: [문서 내용]"
)