robomation

Python versions License

로보메이션(Robomation) 로봇과 AI 확장모듈을 위한 파이썬 패키지입니다.
햄스터 S, 햄스터, 삐오봇, 터틀, Beagle, 라쿤봇, 치즈스틱 등 로보메이션 로봇을 파이썬 코드로 제어하고,
카메라·마이크 기반의 AI 인식 기능(얼굴/손/몸/사물/색깔/마커 인식, 음성 인식, 자율주행)을 손쉽게 사용할 수 있습니다.

Windows / macOS / Chromebook 어느 환경에서든, VSCode 같은 파이썬 환경에서 바로 동작합니다.


설치

pip install -U robomation

요구 사항

  • Python 3.9 이상
  • 로봇 사용 시: USB 동글 또는 시리얼 연결
  • AI 모듈 사용 시: 카메라 / 마이크, 그리고 OS의 카메라·마이크 권한 허용

주요 의존성(pip install -U robomation 시 자동 설치됩니다):
pyserial, numpy, opencv-contrib-python, mediapipe, SpeechRecognition, sounddevice (Windows는 pygrabber 추가).


지원 라이브러리

공통

모듈 설명
Utils 유틸리티

로봇

모듈 설명
HamsterS 햄스터 S
Hamster 햄스터
Pio 삐오봇
Turtle 터틀
Beagle 비글
RaccoonBot 라쿤봇
CheeseStick 치즈스틱

AI 확장모듈

모듈 설명
ASR 음성 인식
FaceDetection 얼굴 찾기
DetailedFaceDetection 상세하게 얼굴 찾기
FaceExpression 나이, 성별, 표정
HandDetection 손 찾기
BodyDetection 몸 찾기
ObjectDetection 사물 인식 찾기
ColorDetection 색깔 찾기
ArucoMarker ArUco 마커 찾기
SelfDriving 카메라 자율주행하기

치즈스틱 확장모듈

모듈 설명
CSD01 스위치
CSD02 RGB LED
CSD03 로터리 퍼텐쇼미터
CSD07 소리 센서
CSD09 모터
CSD10 조도 센서
NeoPixel 네오픽셀
HAT010 HAT-010 5x5 매트릭스
HAT022 HAT-022 터치 피아노
PID13 PID-13 조이스틱과 버튼
PID26 PID-26 환경 센서

사용법 (Usage)

로봇 제어

from robomation import *

hamster_s = HamsterS()
hamster_s.set_wheel_speed('both', 30)

AI 확장 모듈 — 얼굴 인식

from robomation import *

face_detection = FaceDetection(0)
face_detection.device(0)                
face_detection.load_model()             
face_detection.detect_continuous()      

while True:
    if face_detection.detected():
        print(face_detection.face('x'), face_detection.face('y'))
    Utils.wait(0.1)

치즈스틱 확장 모듈 - 네오픽셀

from robomation import *

cheesestick = CheeseStick()
neopixel = cheesestick.NeoPixel()

neopixel.set_range_pattern(1, 1, '3_colors')

참고 사항 (Notes)

  • 카메라/마이크는 OS 권한 허용이 필요합니다.

문서 (Documentation)

자세한 사용법과 예제는 Github Wiki에서 확인할 수 있습니다.


라이선스 (License)

본 라이브러리는 GNU Lesser General Public License v2.1 이상(LGPL-2.1-or-later) 하에 배포됩니다.
자세한 내용은 LICENSE 파일을 참고하세요.

Copyright (c) 2016 Kwang-Hyun Park.
Copyright (c) 2026 Robomation.

Project links

Data verified by PyPI on Aug 18, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.5)

2 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for jwjeong from gravatar.com jwjeong Avatar for robomation from gravatar.com robomation

Credits

PyPI data
Data sourced directly from PyPI's database.

Maintainer: Jiwoo Jeong

Author: Robomation

GitHub Statistics

Data verified by PyPI on Aug 18, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

LGPL-2.1-or-later
View SPDX License List

Requires

Python >=3.9

Tags

robomation roboid robot education ai coding

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

robomation-0.1.4.tar.gz (177.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

robomation-0.1.4-py3-none-any.whl (245.4 kB view details)

Uploaded Python 3

File details

Details for the file robomation-0.1.4.tar.gz.

File metadata

  • Download URL: robomation-0.1.4.tar.gz
  • Upload date:
  • Size: 177.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for robomation-0.1.4.tar.gz
Algorithm Hash digest
SHA256 974f10505d9fe130d815f790a0f4c6ad625eee786d8044d5b185123d63359ca4
MD5 45ab0c311f5fe6e0bd6273fd5dbff850
BLAKE2b-256 68d80f820c8504422a8c0d98d9ee8684d2e54940f87c23a48f313778d5d5be8e

See more details on using hashes here.

Provenance

The following attestation bundles were made for robomation-0.1.4.tar.gz:

Publisher: publish.yml on RobomationLAB/Robomation_Python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file robomation-0.1.4-py3-none-any.whl.

File metadata

  • Download URL: robomation-0.1.4-py3-none-any.whl
  • Upload date:
  • Size: 245.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for robomation-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 dc02c5522ed302ae41e8ba96c69a2dfefb3be0750012c5594d0fb386791d6388
MD5 3a95de40a6c83773755859fe62d30cde
BLAKE2b-256 553c98e9d05af6bb086cc649f140eaaa29898a86f11d3fd1b17cccd16beecfd4

See more details on using hashes here.

Provenance

The following attestation bundles were made for robomation-0.1.4-py3-none-any.whl:

Publisher: publish.yml on RobomationLAB/Robomation_Python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.1.5

2 files

This release

0.1.4 This release

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page