Files
cleveragents-core/docs/quickstart.md
T
HAL9000 ca9dafb1bd
CI / helm (pull_request) Successful in 33s
CI / build (pull_request) Successful in 52s
CI / lint (pull_request) Successful in 1m3s
CI / quality (pull_request) Successful in 1m26s
CI / typecheck (pull_request) Successful in 1m29s
CI / security (pull_request) Successful in 1m33s
CI / push-validation (pull_request) Successful in 22s
CI / e2e_tests (pull_request) Successful in 3m26s
CI / integration_tests (pull_request) Successful in 4m43s
CI / unit_tests (pull_request) Failing after 6m22s
CI / docker (pull_request) Has been skipped
CI / coverage (pull_request) Successful in 10m46s
CI / status-check (pull_request) Failing after 4s
docs: add quick start guide (PR #9245)
Add docs/quickstart.md, update mkdocs navigation, and update CHANGELOG.md to address reviewer request.
2026-04-27 00:09:38 +00:00

1.0 KiB

Quick Start Guide

This quick start guide will walk you through creating a new project, registering a resource, running a plan, and applying changes with CleverAgents.

Prerequisites

  • Python 3.11+ and virtualenv
  • Git
  • A working CleverAgents installation (see development/testing.md for details)

Install (local development)

python -m venv .venv
source .venv/bin/activate
pip install -e .[dev]

Create a new project

# Create a new directory for your project
mkdir my-project && cd my-project
# Initialize a CleverAgents project (example command)
cleveragents init --name my-project

Register a resource

Create a resource file under resources/ (example YAML) and register it with the CLI or API.

Plan and apply

# Generate a plan
cleveragents plan --project my-project
# Review the plan, then apply
cleveragents apply --project my-project

Troubleshooting

If you encounter issues running the examples above, consult docs/development/testing.md and the project README for local development tips.