{"id":44414184,"url":"https://github.com/paritoshk/felos","last_synced_at":"2026-02-12T08:12:42.487Z","repository":{"id":331744979,"uuid":"1131859577","full_name":"paritoshk/felos","owner":"paritoshk","description":"AI Employee that does everything form ad generation to posting to payments using x402 ","archived":false,"fork":false,"pushed_at":"2026-01-11T02:58:00.000Z","size":321,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-11T09:26:20.617Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://felos.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/paritoshk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-10T20:46:31.000Z","updated_at":"2026-01-11T02:58:03.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/paritoshk/felos","commit_stats":null,"previous_names":["paritoshk/felos"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/paritoshk/felos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paritoshk%2Ffelos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paritoshk%2Ffelos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paritoshk%2Ffelos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paritoshk%2Ffelos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paritoshk","download_url":"https://codeload.github.com/paritoshk/felos/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paritoshk%2Ffelos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29361812,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-12T01:03:07.613Z","status":"online","status_checked_at":"2026-02-12T02:00:06.911Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-02-12T08:12:41.801Z","updated_at":"2026-02-12T08:12:42.480Z","avatar_url":"https://github.com/paritoshk.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# felos ⚡\n\n**AI-powered marketing agent with x402 micropayments**\n\nBuilt with **Thesys C1** (Generative UI) + **x402** (Coinbase) + **MongoDB Atlas** + **Fireworks AI**\n\n## Architecture\n\n```\n┌─────────────────────────────────────────────────────────┐\n│              Thesys C1 Chat Interface                    │\n│         (Generative UI with rich components)            │\n└────────────────────────┬────────────────────────────────┘\n                         │\n┌────────────────────────▼────────────────────────────────┐\n│                  Next.js API Route                       │\n│            /api/chat (tool calling)                     │\n└────────────────────────┬────────────────────────────────┘\n                         │\n         ┌───────────────┼───────────────┐\n         ▼               ▼               ▼\n    ┌─────────┐    ┌──────────┐    ┌──────────┐\n    │Firecrawl│    │ Fireworks│    │ Fireworks│\n    │ $0.01   │    │ LLM $0.02│    │FLUX $0.06│\n    └────┬────┘    └────┬─────┘    └────┬─────┘\n         │              │               │\n         └──────────────┼───────────────┘\n                        ▼\n               x402 Micropayments\n                        │\n                        ▼\n                  MongoDB Atlas\n```\n\n## Quick Start\n\n```bash\n# Install\nnpm install\n\n# Configure\ncp .env.local.example .env.local\n# Add your API keys\n\n# Run\nnpm run dev\n```\n\n## API Keys Needed\n\n| Service | Where | Credits |\n|---------|-------|---------|\n| **Thesys C1** | thesys.dev | Sponsor - free |\n| **MongoDB** | mongodb.com/atlas | Hackathon sandbox |\n| **Fireworks** | fireworks.ai | Code `AGENT26` = $50 |\n| **Firecrawl** | firecrawl.dev | Free tier |\n\n## File Structure\n\n```\napp/\n├── page.tsx              # Thesys C1 Thread chat\n├── api/chat/route.ts     # Tool calling endpoint\nlib/\n├── db.ts                 # MongoDB + pricing\n├── tools.ts              # Agent tools (scrape, generate, etc.)\n├── systemPrompt.ts       # Agent personality\n```\n\n## Agent Tools\n\n| Tool | Cost | Description |\n|------|------|-------------|\n| `scrapeProduct` | $0.01 | Extract product info from URL |\n| `generateAdCopy` | $0.02 | Create 3 ad variations |\n| `generateAdImage` | $0.06 | FLUX.1 image generation |\n| `getSpendingReport` | Free | Show savings vs subscriptions |\n\n## The Money Story 💰\n\n**Without felos (DIY subscriptions):**\n- Firecrawl Pro: $99/mo\n- Fireworks: $50/mo\n- Image Gen: $20/mo\n- Copy AI: $30/mo\n- **Total: $199/month**\n\n**With felos (x402):**\n- Complete ad: **$0.09**\n- **Savings: 99.95%**\n\n## Demo Script (2 min)\n\n| Time | Action | Script |\n|------|--------|--------|\n| 0:00 | Show chat | \"This is felos — an AI agent that pays for its own tools via x402\" |\n| 0:15 | Type URL | \"Let's create ads for this product...\" |\n| 0:25 | Watch scrape | \"1 cent to Firecrawl via x402\" |\n| 0:35 | See ad copy | \"2 cents to Fireworks for 3 variations\" |\n| 0:50 | Ask for images | \"Generate images for these ads\" |\n| 1:00 | See images | \"6 cents each via FLUX.1\" |\n| 1:15 | \"Show spending\" | Display savings report |\n| 1:30 | Savings popup | \"**$0.21 total vs $199/month**\" |\n| 1:45 | Explain x402 | \"Agent discovers and pays for services autonomously\" |\n| 2:00 | Close | \"**Stop subscribing. Start creating.**\" |\n\n## Key Demo Commands\n\nTry these in the chat:\n\n1. **\"Create ads for https://amazon.com/dp/B08N5WRWNW\"**\n2. **\"Generate a playful ad for a coffee subscription called BeanBox\"**\n3. **\"Show me my spending report\"**\n4. **\"How much would this cost with subscriptions?\"**\n\n\n## Tagline\n\n\u003e **\"Stop subscribing. Start creating.\"**\n\u003e \n\u003e $199/month in tools → $0.09 per ad\n\n---\n\nBuilt for MongoDB Agentic Orchestration Hackathon • Jan 2026\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparitoshk%2Ffelos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fparitoshk%2Ffelos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparitoshk%2Ffelos/lists"}