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.4.tar.gz (626.8 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.4-py3-none-any.whl (684.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: some1-0.4.4.tar.gz
  • Upload date:
  • Size: 626.8 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.4.tar.gz
Algorithm Hash digest
SHA256 80cf303119b4bd63223c2fbb6ff73179dc29820657f37d11453a019654727671
MD5 422274bc58a26e8c06344f8c41f60732
BLAKE2b-256 54c48b4c9d040953ec5ba8d164b1da7ab3d43572c025cca6f3ba2e9ee9025a4b

See more details on using hashes here.

Provenance

The following attestation bundles were made for some1-0.4.4.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.4-py3-none-any.whl.

File metadata

  • Download URL: some1-0.4.4-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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 51dbc76340fc6705c45f387310c60c818a01e984b394bf7a15fe29f8e8b0982c
MD5 af1dfaa67148e62191334ce41f576f96
BLAKE2b-256 c15ad57e23c19123dc2d37ce7b1658a3cee53500ecf594c16a695184ddb75edd

See more details on using hashes here.

Provenance

The following attestation bundles were made for some1-0.4.4-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