EcoCitizenZ
Beginner20 minutesPython · Python

Generic Python Agent Starter

Fast Start

What you will have in minutes

A locally running, ECZ-ID-backed agent scaffold with resolver-verifiable identity hooks, a credential manifest, and Resolver verification ready to run.

What you do first — in order

1Get starter scaffold2Install dependencies3Go to TrustOps /start4Paste credentials5Run locally6Verify via Resolver7Deploy into your environment

What comes back from TrustOps

  • Agent ECZ-ID(s)
  • Credential manifest (JSON, discovery only)
  • API keys issued in TrustOps

Success looks like

Resolver returns a resolver-verifiable state for your Agent ECZ-ID. You can share it with any party without an account.

1What This Kit Builds

A minimal, unopinionated Python agent scaffold with ECZ-ID identity hooks pre-wired. This is the foundation template for building any custom agent type with resolver-verifiable identity from the ground up. No framework opinions, no platform lock-in.

2Who It Is For

Developers who want maximum flexibility in building custom ECZ-ID-backed agents. Ideal for teams with specific architectural requirements, uncommon agent patterns, or those building entirely new agent types.

3Why ECZ-ID Matters Here

Custom agents built without identity infrastructure become harder to credential retroactively. Starting with ECZ-ID hooks from the ground up means identity is woven into your architecture, not bolted on later. This produces agents designed for serious deployment.

4Architecture

Minimal Agent Core

A clean, extensible agent scaffold with no framework opinions, just the essential patterns.

ECZ-ID Hook Points

Pre-configured integration points for identity context injection, verification, and audit logging.

Configuration System

Environment-based configuration supporting development, sandbox, and production credentials.

Extension Framework

Clear extension points for adding custom capabilities while maintaining identity context.

Pattern Library

Example patterns for common integration scenarios: API calls, data processing, delegation.

Test Harness

Pre-built test fixtures for verifying identity flows in your custom agent logic.

5Build Steps Overview

1
Clone the generic Python starter
Pull the minimal template with ECZ-ID hooks pre-wired.
2
Install core dependencies
Install the ECZ-ID SDK and minimal Python dependencies.
3
Review the scaffold
Understand the hook points, configuration system, and extension patterns.
4
Plan your agent architecture
Design your custom agent logic around the provided identity hooks.
5
Identify required credentials
Determine which ECZ-ID passports your custom agent needs.

Trust Map

Required Passports
ECZ-ID Business PassportAgent Credential
Recommended Passports
API Passport
Relevant Packages
KYA Ready Pack™
What Each Enables
ECZ-ID Business Passport: Organisation identity for custom agent deployment
Agent Credential: Resolver-verifiable identity for your unique, custom-built agent
API Passport: Verified external API handoffs for your custom workflows

6TrustOps Credentialing Checkpoint

TrustOps Credentialing Checkpoint

Pause here to acquire your required ECZ-ID trust objects

This is a designed pause point in your build process. Before continuing, you need to acquire the required ECZ-ID passports and credentials from TrustOps. This midpoint credentialing approach ensures your agent is built with resolver-verifiable identity from the start—not bolted on after the fact.

Required Passports

  • ECZ-ID Business Passport
  • Agent Credential

Recommended Passports

  • API Passport

Relevant Packages

KYA Ready Pack™

What You Must Acquire in TrustOps

ECZ-ID Business Passport
Enables: Parent identity for your organisation
Agent Credential
Enables: Unique resolver-verifiable identity for your custom agent
API Passport (as needed)
Enables: Verified API handoffs if your agent calls external APIs

What You Bring Back from TrustOps

Agent ECZ-ID
Your custom agent’s resolver-verifiable identity string
Agent Credential Manifest
Declared capability metadata customised for your agent
API Keys
Production ECZ-ID API keys for identity operations

9Return and Complete Integration

With your TrustOps credentials in hand, return here to complete the final build steps.

1
Inject agent credentials
Add your Agent ECZ-ID and API keys to the configuration system.
2
Implement custom logic
Build your agent’s unique capabilities around the ECZ-ID identity hooks.
3
Wire identity into your pipeline
Ensure every action in your custom pipeline carries identity context.
4
Test in sandbox
Validate your custom agent’s identity flows in the ECZ-ID sandbox environment.
5
Verify outputs
Confirm all agent outputs carry correct provenance metadata.

10Verify Through Resolver

Verify agent identity

Query your custom agent’s ECZ-ID through Resolver.

Verify custom outputs

Trace any output from your custom agent back to resolver-verifiable identity.

Test external verification

Have an external party verify your agent’s identity through Resolver.

Validate resolver state

Review your agent’s resolver state and contributing evidence factors.

Verify with Resolver

11Deploy Into Your Environment

ECZ-ID-backed agents are portable. Your resolver-verifiable identity travels with your agent regardless of deployment target after TrustOps and Resolver checks. No vendor lock-in.

Any cloud provider
Self-hosted infrastructure
Docker containers
Kubernetes
Serverless functions
Edge compute
Air-gapped environments
Any Python-compatible runtime

12Limits & Non-Claims

  • This kit does not provision credentials. All credentialing happens through TrustOps.
  • This kit provides scaffolding, not a complete agent. You build the custom logic.
  • The generic template is unopinionated and requires architectural decisions from the developer.
  • Identity hooks must be maintained as you build custom logic around them.
  • Resolver state is built up through operational history with real credentials.

Ready to Build This Agent?

Start with the build steps above, credential through TrustOps, and deploy your resolver-verifiable agent anywhere.