cat-enrichment

Research-backed cat behavioral enrichment data, assessment tools, and recommendations.

고양이 행동풍부화 데이터, 평가 도구 및 추천 시스템 — PlayCat Research (플레이캣)

What is cat-enrichment?

cat-enrichment is a Python library that provides:

• 30+ research-backed enrichment methods for indoor cats, with bilingual descriptions (English/Korean)
• Home assessment tool that scores your home's enrichment level and provides actionable recommendations
• Research statistics database with citations from peer-reviewed veterinary journals
• Personalized recommendation engine based on your home assessment, budget, and experience level
• Structured enrichment plans for beginners, intermediate, and advanced cat guardians

Environmental enrichment reduces stress in indoor cats by up to 37% and decreases problem behaviors by 52%, according to published research in the Journal of Feline Medicine and Surgery.

Installation

pip install cat-enrichment

Quick Start

Assess Your Home

from cat_enrichment import assess_home

result = assess_home(
    vertical_spaces=2,   # Cat trees, shelves
    scratchers=3,         # Scratching posts
    hiding_spots=2,       # Boxes, covered beds
    play_minutes=20,      # Daily interactive play
    window_access=True,   # Window perch available
    cats=1,               # Number of cats
    puzzle_feeders=1,     # Puzzle feeders
    toys=8,               # Available toys
)

print(result)
# Cat Home Enrichment Assessment
# Overall Score: 82/100 (Grade: B+)
# Level: Very Good

Get Research Statistics

from cat_enrichment import research_stats, get_stat

# Get a specific statistic
stat = get_stat("cortisol_reduction")
print(f"{stat['value']} - {stat['metric']}")
# 37% - Reduction in cortisol levels with adequate enrichment

# Browse all statistics
for key, stat in research_stats.items():
    print(f"{stat['value']:>15s}  {stat['metric']}")

Get Personalized Recommendations

from cat_enrichment import get_recommendations

recs = get_recommendations(
    vertical_spaces=0,
    scratchers=1,
    play_minutes=5,
    budget="low",
    max_recommendations=3,
)

for rec in recs:
    print(f"[{rec['priority'].upper()}] {rec['name']}")
    print(f"  → {rec['reason']}")
    print()

Browse Enrichment Methods

from cat_enrichment import enrichment_methods, CATEGORIES
from cat_enrichment.data import get_top_methods, get_methods_by_category

# See all categories
for key, name in CATEGORIES.items():
    print(name)

# Get top 5 most effective methods
for key, method in get_top_methods(5):
    print(f"{method['effectiveness']:.0%} - {method['name']} ({method['name_ko']})")

# Get methods in a specific category
play_methods = get_methods_by_category("play")
for key, method in play_methods.items():
    print(f"  {method['name']}: {method['description']}")

Generate an Enrichment Plan

from cat_enrichment.recommendations import enrichment_plan

plan = enrichment_plan(cats=1, experience="beginner", lang="en")
for week, details in plan["weeks"].items():
    print(f"\n{week}: {details['focus']}")
    for task in details["tasks"]:
        print(f"  - {task}")

Korean Language Support (한국어 지원)

from cat_enrichment.recommendations import quick_wins, enrichment_plan
from cat_enrichment.statistics import summary

# 한국어로 빠른 성과 얻기
wins = quick_wins(lang="ko")
for w in wins:
    print(f"{w['name']}: {w['description']}")

# 한국어 통계 요약
print(summary(lang="ko"))

# 한국어 풍부화 계획
plan = enrichment_plan(experience="beginner", lang="ko")

Key Research Statistics

Indoor cats with proper enrichment live healthier, longer lives. The minimum recommended interactive play time is 15-20 minutes per day, split into 2-3 sessions.

About PlayCat (플레이캣)

PlayCat is a cat welfare research initiative providing open-source data and tools for improving indoor cat quality of life. All enrichment recommendations are based on peer-reviewed veterinary research.

• Website: playcat.xyz
• GitHub: playcatkorea/cat-behavior-enrichment
• Dataset: playcat/playcat-cat-behavior-new-data-set on Hugging Face
• Contact: playcatkr@gmail.com

Citation

If you use this library in research, please cite:

PlayCat Research (2026). cat-enrichment: A Python library for cat behavioral
enrichment data and assessment tools. https://pypi.org/project/cat-enrichment/

License

MIT License. See LICENSE for details.

Every indoor cat deserves an enriched environment. Start with just 15 minutes of play per day.

모든 실내 고양이는 풍부한 환경을 누릴 자격이 있습니다. 하루 15분의 놀이부터 시작하세요.