# Ecko

The AI-native scripting language - one batteries-included binary.

This archive contains the `ecko` binary for your platform. There is nothing to
install and nothing to configure: put it on your `PATH` and run it.

```bash
./ecko hello.ecko     # run a file
./ecko                # start the REPL
```

## Putting it on your PATH

```bash
sudo mv ecko /usr/local/bin/          # system-wide
mv ecko ~/.local/bin/                 # just for you
```

On Windows, move `ecko.exe` somewhere on your `PATH`.

Next time, this is one command:

```bash
curl -fsSL https://ecko.sh/install | sh
```

## Check it works

```bash
ecko --version
echo 'print("hello, " + upper("world"))' > hello.ecko && ecko hello.ecko
```

## No API key needed

Without one, `ai` runs in deterministic **mock mode** - typed calls return
schema-valid values, so pipelines, contracts and tests all work offline. Set
`ECKO_API_KEY` for real responses, and `ECKO_AI_PROVIDER` to choose between
`openai` (default), `anthropic` and `ollama`.

## Documentation

Guides, the language reference and the standard library live at
[ecko.sh](https://ecko.sh).

`CHANGELOG.md` in this archive lists what changed in this release.

## License

Ecko is **proprietary software** - free for personal, educational, and
evaluation use; business use requires a commercial license. See `LICENSE` and
[ecko.sh/enterprise](https://ecko.sh/enterprise).
