https://github.com/johnpc/jpc-homie
Smart home assistant powered by AI
https://github.com/johnpc/jpc-homie
Last synced: 5 months ago
JSON representation
Smart home assistant powered by AI
- Host: GitHub
- URL: https://github.com/johnpc/jpc-homie
- Owner: johnpc
- Created: 2025-12-06T22:09:44.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-01-15T00:42:47.000Z (5 months ago)
- Last Synced: 2026-01-15T07:40:13.669Z (5 months ago)
- Language: TypeScript
- Size: 915 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Homie - Smart Home Assistant
A conversational AI assistant for controlling your Home Assistant smart home devices.
## Features
- 🎤 Voice input support
- 🎵 Music playback via Music Assistant
- 💡 Light control and scenes
- 🌡️ Climate control
- 🔧 Real-time tool usage visualization
- 📱 Mobile-friendly interface
- 📶 Eero network device monitoring
## Quick Start with Docker
### Using Docker Compose (Recommended)
```bash
# Create .env file
cat > .env << EOF
HOME_ASSISTANT_URL=https://your-home-assistant.duckdns.org
HOME_ASSISTANT_TOKEN=your_long_lived_access_token
JELLYFIN_URL=https://your-jellyfin-server.com
JELLYFIN_API_KEY=your_jellyfin_api_key
JELLYFIN_USERNAME=your_jellyfin_username
JELLYFIN_PASSWORD=your_jellyfin_password
EOF
# Create data directory for Eero session
mkdir -p data
# Start the service
docker-compose up -d
# View logs
docker-compose logs -f
# Stop the service
docker-compose down
```
### Setting up Eero Network Integration (Optional)
To enable mobile device monitoring:
1. **Authenticate with Eero** (run locally first):
```bash
npm install
npx ts-node eero-auth.ts
```
Follow the prompts to enter your Eero account email and verification code.
2. **Copy the cookie to the data directory**:
```bash
cp eero-session.cookie data/
```
3. **Restart the container**:
```bash
docker-compose restart
```
The Eero session cookie will be automatically refreshed and persisted in the `./data` volume.
### Using Docker directly
```bash
docker run -d \
--name homie \
-p 3000:3000 \
-v $(pwd)/data:/app/data \
-e HOME_ASSISTANT_URL=https://your-ha.duckdns.org \
-e HOME_ASSISTANT_TOKEN=your_token \
-e EERO_COOKIE_PATH=/app/data/eero-session.cookie \
mrorbitman/homie:main
```
### Using pre-built image from Docker Hub
```bash
docker pull mrorbitman/homie:main
```
Open [http://localhost:3000](http://localhost:3000)
## Local Development
```bash
npm install
npm run dev
```
## Environment Variables
- `HOME_ASSISTANT_URL` - Your Home Assistant URL
- `HOME_ASSISTANT_TOKEN` - Long-lived access token from Home Assistant
- `MUSIC_ASSISTANT_URL` - (Optional) Music Assistant server URL for full queue display
Get your token from Home Assistant:
1. Go to Profile → Security → Long-Lived Access Tokens
2. Click "Create Token"
3. Copy the token
## GitHub Actions Setup
Images are automatically built and pushed to Docker Hub on:
- Push to `main` branch → tagged as `main`
- Version tags (e.g., `v1.0.0`) → tagged as `1.0.0` and `1.0`
## License
MIT