lifeos-agent 0.1.0
Your private JARVIS that lives on your laptop — 100% local
License: MIT
Requires Python: >=3.9

# LifeOS-Agent

**Your private AI assistant that lives on your computer — 100% local and free forever**

LifeOS-Agent is a personal AI assistant designed to help you track goals, manage tasks, and plan your day. Everything runs locally on your machine, ensuring complete privacy and control over your data.

---

## Features

- **Goal Tracking** - Set and manage your personal and professional goals
- **AI Chat** - Conversational interface powered by local AI models
- **Web Dashboard** - Beautiful web interface for easy interaction
- **100% Local** - All data stays on your computer
- **Privacy First** - No cloud dependencies, no data collection
- **Free Forever** - Open source and completely free to use

---

## Quick Start

### Installation

Install LifeOS-Agent with a single command:

```bash
pip install lifeos-agent
```

All dependencies are installed automatically.

### Basic Usage

Start the interactive mode:

```bash
lifeos
```

Or use direct commands:

```bash
lifeos add "Learn Python"    # Add a new goal
lifeos list                  # Show all goals
lifeos web                   # Launch web dashboard
lifeos chat                  # Start AI chat mode
```

---

## Commands

| Command | Description | Example |
|---------|-------------|---------|
| `lifeos` | Interactive mode | `lifeos` |
| `lifeos add` | Add a new goal | `lifeos add "Read more books"` |
| `lifeos list` | List all goals | `lifeos list` |
| `lifeos web` | Open web dashboard | `lifeos web` |
| `lifeos chat` | Start chat mode | `lifeos chat` |

---

## Advanced Setup

### Enable AI Features (Optional)

For enhanced AI capabilities, install Ollama:

**Windows:**
```bash
winget install ollama
```

**macOS/Linux:**
```bash
curl -fsSL https://ollama.com/install.sh | sh
```

Then download the AI model:
```bash
ollama pull llama3.1:8b
```

### Install from Source

For developers who want to modify the code:

```bash
git clone https://github.com/VasudevJaiswal/LifeOS-Agent.git
cd LifeOS-Agent
pip install -e .
```

---

## System Requirements

- **Python:** 3.9 or higher
- **Operating System:** Windows, macOS, or Linux
- **Memory:** 2GB RAM minimum (8GB recommended for AI features)
- **Storage:** 100MB for core app (+ 4GB for AI models if using Ollama)

---

## Architecture

LifeOS-Agent is built with:

- **Typer** - Command-line interface
- **Rich** - Beautiful terminal output
- **SQLite** - Local database storage
- **NiceGUI** - Web dashboard interface
- **Ollama** - Local AI model integration

---

## Configuration

LifeOS creates a local database (`lifeos.db`) in your current directory to store:

- Goals and tasks
- Conversation history
- User preferences

To start fresh, simply delete `lifeos.db` and restart the application.

---

## Troubleshooting

### Installation Issues

If you encounter dependency errors:
```bash
pip install --upgrade pip
pip install lifeos-agent --force-reinstall
```

### Database Issues

To reset the database:
```bash
rm lifeos.db  # Linux/macOS
del lifeos.db  # Windows
```

### Voice Features

Voice features require additional setup and may not work on all systems. They are optional and the core functionality works without them.

---

## Development

### Project Structure

```
lifeos-agent/
├── lifeos/
│   ├── cli.py           # Command-line interface
│   ├── main.py          # Core application logic
│   ├── agents/          # AI agent modules
│   ├── memory/          # Memory management
│   ├── tools/           # Utility functions
│   ├── ui/              # Web dashboard
│   │   └── dashboard.py
│   └── voice/           # Voice features (optional)
│       ├── listener.py
│       └── speaker.py
├── pyproject.toml       # Package configuration
├── requirements.txt     # Dependencies
└── README.md           # This file
```

### Running Tests

```bash
python -m pytest tests/
```

### Building from Source

```bash
python -m build
```

---

## Roadmap

- [x] Goal tracking
- [x] CLI interface
- [x] Web dashboard
- [x] AI chat integration
- [ ] Calendar integration
- [ ] Task scheduling
- [ ] Mobile companion app
- [ ] Plugin system

---

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

---

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

---

## Support

- **GitHub Issues:** [Report bugs or request features](https://github.com/VasudevJaiswal/LifeOS-Agent/issues)
- **Documentation:** [Full documentation](https://github.com/VasudevJaiswal/LifeOS-Agent)
- **Repository:** [Source code](https://github.com/VasudevJaiswal/LifeOS-Agent)

---

## Acknowledgments

Built with modern Python tools and libraries. Special thanks to the open-source community for making local AI accessible to everyone.

---

**Version:** 0.1.0  
**Status:** Active Development  
**Privacy:** 100% Local - Your data never leaves your computer