---
id: erppeek
version: "1.7.2"
license: BSD
license_treatment: permissive
maintenance: aging
---

# ERPpeek — Not maintained.  Use Odooly instead

License: permissive · Maintenance: aging · Downloads: 97.2K/mo

## What it is and what it does

ERPpeek is a lightweight client for Odoo and OpenERP systems that works as a command-line tool, interactive shell, or importable library. It provides wrappers around search, read, and data model introspection operations, with simplified syntax for domain queries and field selection. The package supports OpenERP 5.0 through Odoo 11.0 and can be used to inspect and query Odoo objects directly from the command line or within Python scripts.

The tool is no longer actively maintained, and its authors recommend using Odooly as a successor. While it has no external runtime dependencies and installs with low friction, its age and inactive status mean it may lack support for recent Odoo versions and modern Python practices. It remains useful for legacy systems or as a reference implementation, but new projects should evaluate Odooly or other maintained alternatives.

Use it for:

- Query Odoo models and records from the command line without writing custom scripts
- Automate data inspection and reporting tasks against an Odoo instance via shell commands
- Build lightweight Python scripts that interact with Odoo's XML-RPC API without managing connection details manually
- Explore Odoo data structures and field definitions interactively in a shell session
- Manage module upgrades and installations on an Odoo server from the command line

## Worth the install?

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

ERPpeek is a command-line and library client for querying and managing Odoo/OpenERP instances via XML-RPC, with no external runtime dependencies.

No. The package is explicitly marked as unmaintained by its authors, who recommend Odooly instead. While it has no install friction and carries no known vulnerabilities, its inactive status and lack of updates for 211 days mean it likely lacks support for current Odoo versions and will not receive bug fixes or security patches. Install only if you are maintaining legacy code already using ERPpeek.

## Install

pip install erppeek
uv add erppeek
poetry add erppeek

## Installing ERPpeek

Before you install: Installation is frictionless with no runtime dependencies. However, the package is marked inactive and has not been updated in 211 days; the maintainers explicitly recommend Odooly as a replacement.

License in practice: BSD permissive license poses no restrictions on use, modification, or distribution for commercial or private projects.

Quickstart:

pip install erppeek

erppeek --env demo -m res.partner -f name 1

# Or as a library:
from erppeek import Client
client = Client('http://localhost:8069', 'odoo', 'admin', 'password')
partners = client.model('res.partner').read([], 'name')

Requires an accessible Odoo/OpenERP server with XML-RPC enabled; Python 2.7 or Python 3 support varies by Odoo version.

Verify before relying:

- Whether ERPpeek remains compatible with current Odoo versions beyond 11.0
- Whether the package's Python 2.7 support affects its usability on modern systems
- Current state of the project repository and whether it is archived

## Package facts

- License: BSD (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: aging
- Downloads: 97.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

odoo client library, openerp xml-rpc, odoo command line tool, erp data browser, odoo api wrapper, xmlrpc odoo client, odoo shell interactive, unmaintained, odoo-legacy

[View on SkillFed](https://skillfed.io/packages/erppeek) · [View on PyPI](https://pypi.org/project/erppeek/)