Contributing

Gwenflow is open source under the MIT license, at github.com/gwenlake/gwenflow. Contributions are welcome, from a typo to a new feature: open an issue or a pull request.

Set up

The project uses uv:

git clone https://github.com/gwenlake/gwenflow.git
cd gwenflow
uv sync --all-groups --frozen      # the library, every extra and the dev tools

Tests

uv run pytest --record-mode=none                             # the whole suite
uv run pytest tests/test_agents.py::test_name --record-mode=none

Tests that call a provider replay recorded HTTP responses (VCR cassettes, through pytest-recording), so they run without API keys. --record-mode=all re-records them against the live APIs. Tests marked integration call live services: -m "not integration" skips them. The Temporal tests use the SDK’s time-skipping test server, downloaded on first run. internal_tests/ holds integration scenarios (skills, flows, live model calls) that are not part of the default run.

Lint and format

uv run ruff format
uv run ruff check --fix

A pre-commit configuration runs both: pre-commit install.

Licenses

Gwenflow stays usable in commercial products: its dependencies are limited to permissive licenses (MIT, Apache-2.0, BSD), and strong copyleft licenses (GPL, LGPL, AGPL) are refused. licensecheck verifies the dependency tree:

uv run licensecheck --recursive

Layout

Package	Purpose
`gwenflow/agents/`	`Agent`, `CodingAgent`, sub-agents
`gwenflow/llms/`	the provider clients and the table of known models
`gwenflow/tools/`	`BaseTool`, `Tool`, the built-in tools, MCP
`gwenflow/flows/`	`Flow`, `FlowRunner`, `AutoFlow`, the node handlers
`gwenflow/skills/`	skills and their toolset
`gwenflow/memory/`	the history buffers, compaction, long-term memory
`gwenflow/stores/`	memory file stores, OpenSearch
`gwenflow/retriever/`, `vector_stores/`, `readers/`, `parsers/`, `embeddings/`, `reranker/`	the RAG pipeline
`gwenflow/durability/`	Temporal integration
`gwenflow/telemetry/`	OpenTelemetry tracing
`gwenflow/types/`	`Message`, `Document`, responses, events, usage
`gwenflow/registry.py`, `cli.py`	names shared by flows and the command line

Releasing

The version lives in pyproject.toml and gwenflow/version.py, and CHANGELOG.md follows Keep a Changelog. Pushing a vX.Y.Z tag and creating the GitHub release publishes the package to PyPI.

Get started

Concepts

Models

Agents

Multi-agent

Extend

Memory

Flows

Knowledge

Production

Project

Set up

Tests

Lint and format

Licenses

Layout

Releasing

​Set up

​Tests

​Lint and format

​Licenses

​Layout

​Releasing

Set up

Tests

Lint and format

Licenses

Layout

Releasing