Skip to content

Recipes Guide

Recipes are pre-built configuration templates that set up CodeFreedom for specific providers and use cases.

Recipe Sources

Bundled Recipes

These ship with the CodeFreedom repository under recipes/. They cover common provider setups:

  • DeepSeek — DeepSeek API configuration
  • Azure Foundry — Azure OpenAI setup
  • NVIDIA — NVIDIA NIM endpoints
  • OpenRouter — OpenRouter multi-provider routing
  • OpenAI Compatible — Generic OpenAI-compatible endpoints
  • Anthropic Compatible — Generic Anthropic-compatible endpoints
  • Local — Local model inference (Ollama, etc.)

External Recipes

Additional recipes are available from the recipe store at github.com/nilayparikh/codefreedom-recipes. These are community-maintained and cover more specialized setups.

Working with Recipes

List Available Recipes

cf s i -l

Shows both bundled and available store recipes.

Preview a Recipe

cf s i -p <recipe-name>

Shows what the recipe would change without applying it.

cf s i -pa <recipe-name>

Previews the recipe, prompts for confirmation, then applies and validates required secrets. This is the recommended one-step workflow.

Apply a Recipe

cf s i

Applies the default base recipe. Or apply a specific recipe:

cf s i -pa deepseek

Recipe Structure

Each recipe contains:

  • Environment variables — API keys, endpoints, model settings
  • Profile configuration — Agent-specific settings
  • Proxy configuration — LiteLLM routing rules

Recipes merge with your existing configuration. They never overwrite your .env.user file — that's reserved for your personal overrides.

Creating Custom Recipes

See the recipe store documentation for details on creating your own recipes.