Skip to main content

SOME-1: Autonomous AI Employees That Never Sleep

Project description

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

some1-0.4.2.tar.gz (626.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

some1-0.4.2-py3-none-any.whl (684.3 kB view details)

Uploaded Python 3

File details

Details for the file some1-0.4.2.tar.gz.

File metadata

  • Download URL: some1-0.4.2.tar.gz
  • Upload date:
  • Size: 626.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for some1-0.4.2.tar.gz
Algorithm Hash digest
SHA256 37d1b81f6bee4f61f3b0c938f56e6a14429711472ef7c3e43655cab76689df12
MD5 b60c36dddb506a367ba34049eaede5f9
BLAKE2b-256 0433d2f986386ec2c4020c2ff7834575f8b010d5e87c280e0affdd3b28d77bae

See more details on using hashes here.

Provenance

The following attestation bundles were made for some1-0.4.2.tar.gz:

Publisher: pypi-publish.yml on edholofy/some1-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file some1-0.4.2-py3-none-any.whl.

File metadata

  • Download URL: some1-0.4.2-py3-none-any.whl
  • Upload date:
  • Size: 684.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for some1-0.4.2-py3-none-any.whl
Algorithm Hash digest
SHA256 24ece355b6b57a2ffa67424a72aecc151d89cae2d0f6953ab7dc3f61a6d3a748
MD5 597544dca837c21ff2962730245a2f5d
BLAKE2b-256 ae7e0f8e14a90562cecdfe8ecd5b2d1d62da38e75083255505c653810129e16e

See more details on using hashes here.

Provenance

The following attestation bundles were made for some1-0.4.2-py3-none-any.whl:

Publisher: pypi-publish.yml on edholofy/some1-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page