some1 0.4.3

SOME-1: Autonomous AI Employees That Never Sleep

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)

# 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

# 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 (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?

# 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.