---
id: peco
version: "0.1.2"
license: MIT
license_treatment: permissive
maintenance: aging
---

# peco — A library for interacting with the PECO outage map to gain the numbers from it.

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

## What it is and what it does

PECO is a lightweight async-capable client library for fetching outage information from the PECO (Philadelphia Electric Company) outage map. It wraps HTTP requests using aiohttp and parses responses with pydantic, making it straightforward to integrate outage data into Python applications. The library targets modern Python versions (3.8+) and is typed for IDE support.

Typical use involves instantiating a client and calling methods to retrieve current outage counts or details from PECO's public outage map. The package is small and focused—it does not attempt to cache, predict, or analyze outages, only to fetch and structure what the API provides. It's useful for dashboards, alerts, or local monitoring tools that need real-time outage visibility for the PECO service area.

Use it for:

- Build a dashboard or status page that displays current PECO outage counts and affected areas.
- Create an alert system that notifies users when outage numbers exceed a threshold.
- Integrate outage data into a home automation or IoT system to trigger backup power or notifications.
- Collect historical outage snapshots by polling the API at regular intervals for analysis.
- Provide outage context in a local weather or emergency response application.

## Worth the install?

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

A Python library for querying the PECO outage map API to retrieve current outage data and statistics.

Yes, if you need to query PECO outage data and can tolerate infrequent maintenance. The library is permissively licensed, has low install friction, and carries no known vulnerabilities. However, the 564-day release gap and aging maintenance status mean you should verify the PECO API endpoint is still stable and plan to maintain a fork if the upstream project stalls.

## Install

pip install peco
uv add peco
poetry add peco

## Installing peco

Before you install: Low install friction with a pure Python wheel. Maintenance is aging—no release in 564 days despite a recent commit in June 2025—so expect infrequent updates and limited active support.

License in practice: MIT license is permissive; you can use, modify, and distribute this package freely with minimal restrictions.

Quickstart:

pip install peco

import asyncio
from peco import PecoOutageClient

async def check_outages():
    async with PecoOutageClient() as client:
        data = await client.get_outages()
        print(data)

asyncio.run(check_outages())

Requires Python 3.8.1 or later. The PECO outage map endpoint must be publicly accessible and unchanged from when the library was last maintained.

Verify before relying:

- Whether the PECO outage map API endpoint remains stable and accessible without authentication.
- Real-world reliability and error handling when PECO's service is unavailable or changes its data format.
- Whether aiohttp and pydantic versions are pinned or if there are known compatibility issues with recent releases.

## Package facts

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

## Tags

peco outage map api, power outage data python, peco outage status, electricity outage api, peco power grid monitoring, outage map scraper, peco api client, outage-monitoring, async-http, peco

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