cooklang-import 0.9.9

A tool for importing recipes into Cooklang format
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133

# cooklang-import

A tool to import recipes into [Cooklang](https://cooklang.org/) format using AI-powered conversion. Hosted version runs via https://cook.md

## Features

- **Multi-provider AI support**: OpenAI, Anthropic Claude, Azure OpenAI, Google Gemini, and Ollama
- **Automatic fallback**: Seamlessly switch between providers on failure
- **Smart extraction**: JSON-LD, MicroData, HTML class extractors, and LLM fallback
- **Multiple input types**: URLs, plain text, and images (via OCR)
- **Local AI support**: Run completely offline with Ollama

See [architecture.md](architecture.md) for system design.

## Installation

### CLI

```sh
git clone https://github.com/cooklang/cooklang-import
cd cooklang-import
cargo install --path .
```

### Rust Library

```toml
[dependencies]
cooklang-import = "0.8.6"
```

See [docs/api-rust.md](docs/api-rust.md) for library usage.

### Mobile SDKs

- [iOS (Swift)](docs/sdk-ios.md) - Swift Package Manager or manual installation
- [Android (Kotlin)](docs/sdk-android.md) - GitHub Packages (Maven) or manual installation

## Quick Start

Set your API key:

```sh
export OPENAI_API_KEY="your-api-key-here"
```

The tool works immediately with OpenAI's GPT-4.1-mini model.

## Usage

### URL to Cooklang

```sh
cooklang-import https://www.bbcgoodfood.com/recipes/next-level-tikka-masala
```

### URL to Recipe (Extract Only)

```sh
cooklang-import https://www.bbcgoodfood.com/recipes/next-level-tikka-masala --extract-only
```

### Text to Cooklang

```sh
cooklang-import --text "Take 2 eggs and 1 cup of flour. Mix and bake at 350°F for 30 minutes."
```

### Image to Cooklang

Requires `GOOGLE_API_KEY` for OCR.

```sh
cooklang-import --image /path/to/recipe-photo.jpg
```

### Options

```sh
cooklang-import --help                           # Full usage info
cooklang-import <url> --provider anthropic       # Use specific provider
cooklang-import <url> --timeout 60               # Custom timeout (seconds)
```

## Configuration

### Basic (config.toml)

```sh
cp config.toml.example config.toml
```

```toml
default_provider = "openai"

[providers.openai]
enabled = true
model = "gpt-4.1-mini"

[providers.anthropic]
enabled = true
model = "claude-sonnet-4.5"

[fallback]
enabled = true
order = ["openai", "anthropic"]
```

See [docs/providers.md](docs/providers.md) for all provider options.

### Configuration Priority

1. Environment variables (e.g., `OPENAI_API_KEY`)
2. `config.toml` file
3. Default values

## Documentation

| Document | Description |
|----------|-------------|
| [architecture.md](architecture.md) | System design and project structure |
| [docs/providers.md](docs/providers.md) | AI provider configuration |
| [docs/api-rust.md](docs/api-rust.md) | Rust library API |
| [docs/sdk-ios.md](docs/sdk-ios.md) | iOS/Swift SDK |
| [docs/sdk-android.md](docs/sdk-android.md) | Android/Kotlin SDK |
| [docs/troubleshooting.md](docs/troubleshooting.md) | Common issues and solutions |

## Development

```sh
cargo test                              # Run tests
RUST_LOG=debug cooklang-import <url>    # Debug logging
```