Skip to content

Terminal and HTTP application quickstart

This quickstart installs the crystal-lattice command, starts its HTTP server, and verifies a concrete response without requiring provider credentials.

Install

Choose the supported method for your platform:

Then verify:

crystal-lattice --help

For a source checkout, run from the repository root:

python -m pip install -e "core/python[dev]"
python -m pip install -e application/python

Start a local server

Create a workspace and start the server with project-local configuration:

mkdir -p ~/crystal-lattice-demo
cd ~/crystal-lattice-demo
crystal-lattice --config-local --host 127.0.0.1 --port 9000

The command creates .crystal/config.json when it is missing and listens on http://127.0.0.1:9000.

Verify the result

From another terminal:

curl http://127.0.0.1:9000/api/hello

The response contains:

{
  "message": "Hello from Bonjour Server!",
  "timestamp": "<UTC timestamp ending in Z>",
  "method": "GET"
}

Stop the server with Ctrl-C.

Continue

bash crystal-lattice --server --console --config-local