Metadata-Version: 2.4
Name: lobby-ai
Version: 1.1.1
Summary: 🏢 LOBBY - AI concierge service that multiplies your existing CLI tools
Project-URL: Homepage, https://lobby.directory
Project-URL: Repository, https://github.com/franco/lobby-ai
Project-URL: Documentation, https://lobby.directory/docs
Project-URL: Bug Reports, https://github.com/franco/lobby-ai/issues
Author-email: Franco <support@lobby.directory>
License: MIT
License-File: LICENSE
Keywords: ai,claude,cli,concierge,cursor,gemini,mcp,orchestration
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Requires-Dist: cryptography>=41.0.0
Requires-Dist: httpx>=0.24.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.9.0
Provides-Extra: all
Requires-Dist: flask-cors>=4.0.0; extra == 'all'
Requires-Dist: flask>=2.3.0; extra == 'all'
Requires-Dist: inquirerpy>=0.3.4; extra == 'all'
Requires-Dist: mcp>=1.0.0; extra == 'all'
Requires-Dist: prompt-toolkit<4.0.0,>=3.0.0; extra == 'all'
Requires-Dist: questionary>=2.0.0; extra == 'all'
Requires-Dist: stripe>=5.0.0; extra == 'all'
Provides-Extra: billing
Requires-Dist: flask-cors>=4.0.0; extra == 'billing'
Requires-Dist: flask>=2.3.0; extra == 'billing'
Requires-Dist: stripe>=5.0.0; extra == 'billing'
Provides-Extra: dev
Requires-Dist: mypy>=1.7.0; extra == 'dev'
Requires-Dist: pre-commit>=3.6.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
Requires-Dist: pytest>=7.4.0; extra == 'dev'
Requires-Dist: ruff>=0.5.0; extra == 'dev'
Provides-Extra: interactive
Requires-Dist: inquirerpy>=0.3.4; extra == 'interactive'
Requires-Dist: prompt-toolkit<4.0.0,>=3.0.0; extra == 'interactive'
Requires-Dist: questionary>=2.0.0; extra == 'interactive'
Provides-Extra: mcp
Requires-Dist: mcp>=1.0.0; extra == 'mcp'
Description-Content-Type: text/markdown

# 🏢 LOBBY - AI Concierge for CLI Tools

<!-- mcp-name: io.github.devopsfranco/lobby -->

**Multiply your existing CLI tools with intelligent AI orchestration**

LOBBY is an AI concierge service that works **with** your existing CLI tools (Claude, Gemini, Cursor, etc.) to provide intelligent task routing and execution planning. It doesn't replace your tools - it makes them smarter.

## ⚡ Quick Install

```bash
# Node (npx wrapper)
npx lobby-ai --help

# Python (user local)
pip install lobby-ai

# Isolated, recommended for CLIs
pipx install lobby-ai
# or
uvx lobby-ai --help
```

That's it! 🎉

## 🚀 What is LOBBY?

LOBBY multiplies your CLI tools by providing:

1. **🎯 Intelligent Routing** - Optimal model selection for each task type
2. **💰 Cost Optimization** - Prefers free models, shows real costs
3. **🔌 MCP Server** - Works with Claude CLI, Gemini CLI, Cursor, any MCP tool
4. **🏢 NYC Concierge** - Professional service that elevates your workflow

## 🛠️ How It Works

LOBBY runs as an **MCP (Model Context Protocol) server** that your existing CLI tools can connect to:

- **Claude CLI** → calls LOBBY for smart orchestration
- **Gemini CLI** → calls LOBBY for cost optimization  
- **Cursor IDE** → calls LOBBY for task routing
- **Any MCP tool** → gets LOBBY's AI concierge services

## 🎯 What You Get

### **Intelligent Routing**
- **Coding tasks** → DeepCoder (free) or Claude-3.5 Sonnet
- **Writing tasks** → GPT-4 or Claude-3 Opus  
- **Analysis tasks** → Gemini 1.5 Pro or Llama-3.1
- **Creative tasks** → DALL-E + GPT-4 or Midjourney API

### **Cost Optimization** 
- Prefers **FREE models** (agentica-org/deepcoder:free, etc.)
- Routes to cheapest option that meets quality requirements
- Shows real-time cost estimates
- Usage tracking and billing

### **Professional Execution Plans**
- Multi-step actionable plans with shell commands
- Quality assurance checkpoints
- Expected deliverables and outcomes

## 🚀 Setup (30 seconds)

```bash
# 1. Install with basic features
pip install lobby-ai

# Or install with interactive prompts (recommended)
pip install 'lobby-ai[interactive]'

# 2. Configure (auto-detects Claude, Gemini, etc.)
lobby setup

# 3. Start using through your existing CLI tools!
```

### ✨ Interactive Setup Wizard

With the `[interactive]` extras installed, you get a beautiful setup wizard:

```bash
lobby setup
# ✅ Interactive API key entry (secure password input)
# ✅ Choose default agent from menu (developer, writer, analyst, etc.)
# ✅ Select preferred AI model with cost indicators
# ✅ Configure tools and preferences
```

## 📋 Usage Examples

### Interactive Request Mode
```bash
# Interactive mode with menus and selections
lobby request "Build a web scraper"
# ✅ Select agent specialization
# ✅ Choose AI model (with FREE options highlighted)
# ✅ Pick tools to enable
# ✅ Configure advanced options

# Non-interactive for automation
lobby --no-interactive request "Build a web scraper" \
  --agent developer --model auto --tools code-execution,web-search
```

### Pattern Management
```bash
# Create reusable task patterns
lobby patterns new
# ✅ Interactive pattern builder with variables
# ✅ Save templates for common tasks

# Run saved patterns
lobby patterns run "Code Review"
# ✅ Fill in template variables
# ✅ Execute with saved preferences

# List all patterns
lobby patterns list
```

### In Claude CLI:
```bash
claude> Use LOBBY to build a Python web scraper for Hacker News
claude> Ask LOBBY to analyze my GitHub repo structure
claude> Get LOBBY to write a technical blog post about AI agents
```

### In Gemini CLI:
```bash
gemini> Use LOBBY orchestration to create a React dashboard
gemini> Have LOBBY optimize my database queries
```

## 🏢 MCP Tools Available

Once installed, these tools are available to all your CLI clients:

- **`orchestrate_task`** - Full AI task orchestration with optimal routing
- **`analyze_routing`** - Preview which models would be selected  
- **`check_usage`** - View your usage and billing status

## 💳 Pricing

- **Free**: 10 orchestrations per day
- **After free tier**: $0.01 per orchestration
- **Professional**: $29/month (2,500 orchestrations)
- **Enterprise**: $99/month (unlimited)

*Note: You still pay model providers directly (OpenRouter, Anthropic, etc.). LOBBY charges only for the orchestration service.*

## ⚙️ Requirements

- Python 3.8+
- An OpenRouter API key (get free credits at [openrouter.ai](https://openrouter.ai))
- At least one MCP-compatible CLI tool:
  - [Claude CLI](https://claude.ai/cli) 
  - [Gemini CLI](https://ai.google.dev/cli)
  - [Cursor IDE](https://cursor.sh)
  - Any other MCP-compatible tool

## 🎯 Philosophy

**LOBBY multiplies your existing tools instead of replacing them.**

We believe the future is multi-model, multi-provider. Instead of being locked into one AI company's tools, LOBBY lets you:

✅ **Keep using** Claude CLI, Gemini CLI, Cursor, etc.  
✅ **Add intelligence** through optimal model routing  
✅ **Save money** with cost optimization and free models  
✅ **Get better results** with task-specific model selection  

## 📚 Further docs

- Build from source (pyproject):
  - python -m build  # requires build
  - pip install -U build && python -m build
  - pip install dist/*.whl
- Pre-commit hooks: pre-commit install
- Lint/format: ruff format . && ruff check . --fix

- See USER_GUIDE.md for a complete command reference and user journey walkthrough
- See IMPLEMENTATION_SUMMARY.md for architecture details and testing

## 📚 Support

- **Website**: [lobby.directory](https://lobby.directory)
- **GitHub Issues**: [github.com/franco/lobby](https://github.com/franco/lobby)
- **Email Support**: support@lobby.directory

## License

MIT License - see [LICENSE](LICENSE) file.

---

**Made with ❤️ in NYC** - Your AI concierge is ready to serve!
