some1 0.4.4
SOME-1: Autonomous AI Employees That Never Sleep
License: MIT
Requires Python: >=3.9

# SOME-1: Your AI Employee

> **⌐■_■ Will work for tokens.**

Create AI employees that work 24/7 — browsing, trading, researching — for pennies.

## Quick Start (2 minutes)

```bash
# 1. Install
cd SOME-1
pip install -e .

# 2. Run
some1
```

That's it! On first run, you'll be prompted for an API key:

```
┌─ Setup Required ─────────────────────────┐
│ ⚠️  No API Key Found                     │
│                                          │
│ Get a free key (takes 30 seconds):       │
│   1. Go to https://openrouter.ai         │
│   2. Sign up (free) and copy your key    │
│   3. Paste it below                      │
└──────────────────────────────────────────┘

Paste your OpenRouter API key:
API Key > ████████████████
✓ API key saved to .env
```

Then you'll see:

```
        ⌐■_■  SOME-1 v0.1.0
      Will work for tokens.

┌─ First Time? ─────────────────────────┐
│ /new           Create your first      │
│                employee (2 min)       │
│ /deploy        Pick a template        │
│ /help          See all commands       │
└───────────────────────────────────────┘
```

## Create Your First Employee

```
some1> /new
→ Pick template: crypto, researcher, social, leads, or custom
→ MCPs auto-install (Jupiter, Birdeye, etc.)
→ Enter API keys when prompted
→ Done!

some1> /use CryptoTrader
CryptoTrader> Check my SOL balance
```

## What Can SOME-1 Do?

| Employee Type | What They Do | Cost/Task |
|--------------|--------------|-----------|
| **CryptoTrader** | Trade on Solana, monitor prices, execute swaps | ~$0.03 |
| **Researcher** | Search web, read pages, create reports | ~$0.02 |
| **Lead Generator** | Find companies, scrape contacts, qualify leads | ~$0.05 |
| **Social Manager** | Post to Twitter, Discord, Telegram | ~$0.01 |
| **Browser Worker** | Fill forms, click buttons, extract data | ~$0.03 |

## Run 24/7 Autonomously

```bash
# Start autonomous daemon
some1
/autonomous add CryptoTrader "Monitor BTC and alert on 5% drops" 5

# Or use the trading shortcut
/trading CryptoTrader SOL,BONK 5
→ Runs every 5 minutes
→ Auto-recovers from errors
→ Learns from experience
```

Leave the terminal open — your employee works in the background.

## Key Commands

| Command | What it does |
|---------|--------------|
| `/new` | Create employee with tools & credentials |
| `/use <name>` | Chat with an employee |
| `/employees` | List your team |
| `/autonomous` | Set up 24/7 tasks |
| `/help` | All commands |

## Requirements

- Python 3.10+
- Node.js (for MCP servers)
- API key from [OpenRouter](https://openrouter.ai) (free tier available)

## Cost

SOME-1 uses cost-optimized AI models:

- Simple tasks: **$0.01-0.03**
- Complex research: **$0.05-0.10**
- Trading automation: **$0.03/check**

Compare to: hiring a VA ($5-15/hr), or other AI tools ($20-100/mo)

## Architecture

```
┌─────────────────────────────────────────┐
│           SOME-1 Employee               │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  │
│  │Training │  │ Memory  │  │Schedule │  │
│  └─────────┘  └─────────┘  └─────────┘  │
└────────────────────┬────────────────────┘
                     │
         ┌───────────┼───────────┐
         v           v           v
    ┌─────────┐ ┌─────────┐ ┌─────────┐
    │ Jupiter │ │ Birdeye │ │ Browser │
    │  (MCP)  │ │  (MCP)  │ │  (MCP)  │
    └─────────┘ └─────────┘ └─────────┘
```

**MCP Servers** provide tools: trading APIs, web search, browser control, etc.

**Employees** have:
- Training (what you tell them)
- Memory (what they learn)
- Schedules (automated tasks)
- Skills (allowed tools)

## Troubleshooting

**Missed the API key prompt?**
```
some1
/config OPENROUTER_API_KEY=your-key
```

**npm not found?**
```bash
# Install Node.js first (required for MCP servers)
brew install node  # Mac
# or download from nodejs.org
```

**MCP server failed?**
```
/mcp status        # Check connections
/mcp reconnect     # Try again
```

**Want to change API key?**
```
/config OPENROUTER_API_KEY=new-key
```

## Learn More

- `/help` — Command reference
- `/help <command>` — Specific help (e.g., `/help new`)
- `/help all` — Complete reference

---

**⌐■_■ SOME-1**: *Will work for tokens.*