---
id: python-alfresco-api
version: "1.2.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# python-alfresco-api — Python Client for all Alfresco Content Services REST APIs, with Pydantic v2 Models, and Event Support

License: permissive · Maintenance: active · Downloads: 277.1K/mo

## What it is and what it does

This is a modern Python client for Alfresco Content Services that wraps all 7 Alfresco REST APIs (Auth, Core, Discovery, Search, Workflow, Model, Search SQL) into a unified, type-safe interface. It uses a dual model architecture—attrs-based models for raw API responses and separate Pydantic models for AI/LLM integration—and supports both synchronous and asynchronous calls. The library includes a factory pattern for centralized authentication and configuration, making it straightforward to create individual clients that share a single session.

The package is built for developers integrating Alfresco into Python applications, particularly those working with AI frameworks like LangChain or LlamaIndex, or building MCP servers. It includes ActiveMQ (STOMP) event support so your Python app can listen to repository change events, and it works with Alfresco running in Docker or on-premises. All 12 runtime dependencies are included by default—no optional extras needed—and the library is actively maintained with comprehensive documentation and test coverage.

Use it for:

- Building AI/LLM applications that query and manage documents in Alfresco using Pydantic models.
- Creating MCP servers that expose Alfresco content and workflows to language models.
- Automating document management workflows by programmatically creating, updating, and searching content.
- Listening to Alfresco repository events in real-time via ActiveMQ to trigger downstream Python processes.
- Integrating Alfresco with Python-based data pipelines or ETL workflows.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Python client library for Alfresco Content Services REST APIs, supporting all 7 Alfresco APIs with both synchronous and asynchronous calls, Pydantic models for AI integration, and ActiveMQ event support.

Yes. The package is actively maintained, has zero known vulnerabilities, supports modern Python versions (3.10–3.14), carries a permissive Apache-2.0 license, and installs with low friction. It covers a complete API surface for Alfresco integration and is well-suited for production use in document management, AI/LLM workflows, and event-driven automation. Install it if you need a Python client for Alfresco Content Services.

## Install

pip install python-alfresco-api
uv add python-alfresco-api
poetry add python-alfresco-api

## Installing python-alfresco-api

Before you install: Low friction installation with a pure-Python wheel and 12 common runtime dependencies. Active maintenance with a release 8 days ago. Supports Python 3.10 through 3.14.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions, making it suitable for most production deployments.

Quickstart:

pip install python-alfresco-api

from python_alfresco_api import ClientFactory

factory = ClientFactory(
    base_url="http://localhost:8080",
    username="admin",
    password="admin"
)
core_client = factory.create_core_client()

Requires Python 3.10 or later; an Alfresco Content Services instance (local or remote) to connect to.

Verify before relying:

- Whether all 7 Alfresco REST APIs are fully implemented or if some endpoints remain incomplete.
- Performance characteristics and rate-limiting behavior under high concurrency.
- Compatibility with specific Alfresco versions beyond the Community 25.2 / 26.1 mentioned in docs.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 277.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

alfresco rest api client, content management python, document management api, alfresco async client, ecm python library, alfresco pydantic models, ai integration alfresco, content-management, async-support, ai-ready

[View on SkillFed](https://skillfed.io/packages/python-alfresco-api) · [View on PyPI](https://pypi.org/project/python-alfresco-api/)