AI-RPi-detection - GitLite

KO | EN

gitlite — search

#hacktoberfest #react #typescript #llm #golang #machine-learning #rust #nodejs #macos #windows #cli #security #pytorch #openai

AI-RPi-detection

(★ 195)

AI Raspberry Pi cat detection and notification: get a text when your cat does something it's not supposed to do, and have AI narrate what it sees. Generalizable across other use cases outside of cats

파일 탐색기

최종 버전 다운로드 (.zip)

- - cookie.jpeg
  - demo.mp4
  - pixel.jpg
  - sophie.jpg
  - tangerine.jpg
- contributors.mdx
- dev-environment.mdx
- favicon.png
- introduction.mdx
- mint.json
- quickstart.mdx
- README.md
.env.example
.gitignore
camera.py
interesting_list.py
LICENSE
README.md
requirements.txt

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/ykhli/AI-RPi-detection

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd AI-RPi-detection

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Python

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Python 3 설치 시 'Add Python to PATH' 옵션을 꼭 체크하세요 (Windows).

pip install -r requirements.txt

requirements.txt 등에 명시된 파이썬 라이브러리를 설치합니다.

python <실행할 파일명>.py # README에서 정확한 실행 파일명을 확인하세요

파이썬 스크립트(또는 모듈)를 실행합니다.

✅ 에러 메시지 없이 실행되고 터미널에 안내 문구가 출력되면 정상입니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## AI Raspberry Pi Cat Detection 🐱

AI Raspberry Pi cat detection and notification: get a text/email when your cat does something it's not supposed to do, and have AI narrate what it sees 👁️

This RPi starter kit makes it easy to get started with AI (both running device model & calling an LLM), and it's generalizable across other vision-related use cases.

**Demo** (sound on 🔊):

[![AI cat detection demo](http://img.youtube.com/vi/8KSAiwyDoy8/0.jpg)](http://www.youtube.com/watch?v=8KSAiwyDoy8 "AI Cat Detection & Narration")

https://www.youtube.com/watch?v=8KSAiwyDoy8

Have questions? Join [AI Stack devs](https://discord.gg/TsWCNVvRP5)

This starter kit is super simple: it allows you to use your Raspberry Pi to monitor what your cat does at home, and email you when your cat does something it's not supposed to do. **My #1 use case is detecting if my cats are jumping on my dinning table or kitchen counter.** You could also opt to turn this into an AI narrator, where the voice narrates on everything it sees.

Of course this doesn't just work for cats 😄. You are welcomed to simply change the prompts and do other kinds of detections:

- 🐦 for bird watching: email a summary of what birds came by during the day, for the birdies
- 🐻 Racoon deterrent (I have not tried this, but you can?): play loud sound when AI sees Racoons going through your trash cans. You need an external speaker attached to your RPi if you want to do this.
- 🪴 Plant monitor: email you when your plants are dying from not being watered
- 📦 Package alert: email when there's a new package delivered at the door, even better, AI can tell you if it's a big one
- (submit your fun use cases!)

## Stack

- 🧠 Multi-modal models: OpenAI
- 📫 Notification: [Resend](https://resend.com/)
- 📢 Narration (optional): [ElevenLabs](https://elevenlabs.io/)
- 💻 Orchestration and function calling: [Langchain](https://python.langchain.com/docs/get_started/introduction/)
- 📖 Docs: [Mintlify](https://ai-cat-detection.yoko.dev/introduction)
- 🐱 Cats

## Overview

- 🚀 [Quickstart](#quickstart)
- 💻 [Dev Environment](#dev-environment)

## Quickstart

To try out this starter kit, you need a Raspberry Pi with a camera module, optionally a speaker module for narration!

I can send you one if you are one of the first few lucky people to try this kit :). Discord DM me.

For detailed setup instructions, visit our docs page [here](https://ai-cat-detection.yoko.dev/) (powered by [Mintlify](https://mintlify.com/))

## Dev Environment

You can find helpful tips on setting up dev environment [here](https://ai-cat-detection.yoko.dev/dev-environment)

## FAQ

For common questions and bugs, feel free to try out our AI Q&A bot [here](https://ai-cat-detection.yoko.dev/introduction). You could simply type on the search bar or use cmd+k shortcut.