Skip to main content

Agents From Scratch

Project description

Agents From Scratch

agents_from_scratch is a small Python project for learning agent design from first principles. It focuses on a clear baseline: tool registration, simple tool routing, and predictable behavior.

Project goals

  • Keep the core agent logic small and easy to inspect.
  • Provide runnable examples for experimentation.
  • Offer a clean package foundation that can grow into more advanced agents.

What is included

  • SimpleAgent: a minimal text agent with pluggable tools.
  • Built-in sample tools:
    • upper for text transformation.
    • math for basic arithmetic evaluation.
  • CLI demo entrypoint: agents-from-scratch-demo.
  • Example script and tests to show expected behavior.

Quick start

uv sync
uv run agents-from-scratch-demo

Try prompts like:

  • help
  • upper: hello world
  • math: (2 + 3) * 4
  • what can you do?

Repository layout

  • agents_from_scratch/: package source code
  • examples/: runnable examples
  • tests/: package tests

Package name

The distribution name is agents-from-scratch, and the import package is agents_from_scratch.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agents_from_scratch-0.1.0.tar.gz (8.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agents_from_scratch-0.1.0-py3-none-any.whl (11.7 kB view details)

Uploaded Python 3

File details

Details for the file agents_from_scratch-0.1.0.tar.gz.

File metadata

  • Download URL: agents_from_scratch-0.1.0.tar.gz
  • Upload date:
  • Size: 8.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for agents_from_scratch-0.1.0.tar.gz
Algorithm Hash digest
SHA256 754871a5736f92b51f4278e578e6084dbec389da4789bfc9fe83cf6b71f47ba8
MD5 c81bf7a0ccaa651d1c59dbc6ba0b214d
BLAKE2b-256 a1616c89aabf912f5ff2f2c04f03b7b7fb86d0fd490ec1ce2c38bdc4b9ee2b0e

See more details on using hashes here.

File details

Details for the file agents_from_scratch-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for agents_from_scratch-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 13a94f6607d1a0373d2495dd9d6dd62b00831ee16e4b045f58f556ba61044956
MD5 28d7433539161b934ca5ac5558de5547
BLAKE2b-256 96a4185d8cb51c6d93f5bfe76ae3ff7a196e393876897c478ebda4a9d421abf9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page