How to Use Paperclip to Build Your First AI Company: A Step-by-Step Tutorial
Learn how to install Paperclip, configure AI agents, import skill packs, and launch a fully operational AI company. A practical step-by-step tutorial for beginners.
You've heard about AI agents running entire companies. You've seen the revenue screenshots. Now you want to build one yourself. This tutorial walks you through the entire process — from installing Paperclip to having a fully operational AI company with 17 agents executing your strategy.
Prerequisites
Before you start, you'll need:
• Node.js 20 or higher installed on your machine • pnpm 9.15+ (install with: npm install -g pnpm) • A terminal you're comfortable with • An API key for at least one AI provider (OpenAI, Anthropic, or similar)
You don't need prior experience with AI agents or multi-agent systems. This guide assumes you're starting from zero.
Step 1: Install Paperclip
The fastest way to get Paperclip running is the one-line installer:
npx paperclipai onboard --yes
This command downloads Paperclip, sets up the embedded PostgreSQL database, configures the default settings, and launches the server. Once complete, open http://localhost:3100 in your browser to access the Paperclip dashboard.
For manual installation (useful if you want more control):
git clone https://github.com/paperclipai/paperclip.git cd paperclip pnpm install pnpm dev
The development server starts with hot-reload, so any configuration changes take effect immediately.
Step 2: Understand the Organizational Structure
Paperclip models your AI company as an actual organization. At the top sits you — the board member. Below you is a CEO agent that orchestrates everything. The CEO delegates to department directors (CMO, CTO, COO), who manage specialist agents (content writers, engineers, designers, salespeople).
This hierarchy isn't just for show. It determines how tasks flow through the system. When you give a high-level directive like "launch a blog and publish weekly content," the CEO breaks it down, assigns it to the CMO, who delegates to the Content Writer and SEO Analyst agents. Each agent knows its role, its manager, and its responsibilities.
You define this structure in your Paperclip configuration. Each agent needs an identity (who it is), a heartbeat schedule (when it works), collaboration rules (who it talks to), and tools (what it can do).
Step 3: Import a Pre-Configured Skill Pack
This is where the magic happens. Instead of manually defining 17 agents and their configurations, you can import a skill pack from PaperclipOrg that gives you a complete, pre-configured organization.
Purchase and download a skill pack from papercliporg.com. The SaaS Factory pack, for example, includes 17 agents and 8 production skills covering the entire SaaS lifecycle.
Unzip the downloaded file into your Paperclip project directory. The pack includes:
• Agent configuration files (soul.md, heartbeat.md, agents.md, tools.md for each of the 17 agents) • Skill definitions in structured YAML format • Templates, scripts, and reference documents • The organizational hierarchy definition
Paperclip auto-discovers the new agents and skills the moment you place the files in the correct directories. No restart required — the heartbeat system picks up the new configurations on the next cycle.
Step 4: Configure Your Company Mission
With agents imported, you need to give your company direction. Open the Paperclip dashboard and define your company's mission, target market, and initial objectives.
Be specific. Instead of "build a SaaS product," say "build a project management tool for freelance designers that charges $29/month, targeting the US market, launching within 60 days." The more specific your direction, the better your agents perform.
The CEO agent takes your mission and breaks it into department-level objectives. The CTO gets engineering goals. The CMO gets marketing targets. The sales director gets pipeline metrics. Each department then creates specific tasks for their specialist agents.
Step 5: Set Budgets and Governance
Before letting agents run, set spending limits. Paperclip lets you define monthly per-agent budgets that cap token costs. A typical setup might allocate:
• CEO: $50/month (strategic planning, delegation) • Department Directors: $30/month each (coordination, review) • Specialist Agents: $15-20/month each (execution)
This keeps total AI costs predictable while giving agents enough runway to be productive. You can also set approval gates — requiring human sign-off before agents make certain decisions, hire new agents, or change strategic direction.
Start conservative. You can always increase budgets once you see which agents generate the most value.
Step 6: Launch and Monitor
With agents configured, mission defined, and budgets set, activate the heartbeat system. Agents begin their scheduled routines — checking tasks, executing skills, reporting results, and coordinating with each other.
Use the Paperclip dashboard to monitor progress in real-time. The ticket system shows every task, who's working on it, and what tool calls were made. The audit log provides complete traceability.
In the first few days, watch for:
• Agents producing work that matches your expectations • The organizational hierarchy working as intended (tasks flowing down, reports flowing up) • Budget consumption rates (adjust if agents are burning through tokens too fast) • Quality of outputs (you may need to refine agent soul files for better results)
Step 7: Iterate and Scale
Your first week won't be perfect. Some agents will produce mediocre output. Some workflows will need refinement. This is normal.
The advantage of pre-configured skill packs is that they give you a proven starting point. Instead of debugging an empty system, you're refining a working one. Edit the soul.md files to adjust agent personalities. Modify skill definitions to match your specific industry. Add custom templates that reflect your brand.
As you find what works, scale it. Add more skill packs for new departments. Increase budgets for high-performing agents. The beauty of Paperclip is that scaling means importing more configurations, not hiring more people.
What's Next
You now have a functional AI company running on Paperclip with pre-configured agents executing your strategy. The next steps are:
• Customize agent configurations to match your brand and industry • Add more departments with additional skill packs as they become available (Agency in a Box and E-Commerce Empire are coming soon) • Join the Paperclip community on Discord for tips and collaboration • Track your results and share your success story
The gap between installing Paperclip and running a profitable AI company is smaller than you think. The hard part — configuring agents, defining workflows, building organizational structures — is already solved by pre-configured skill packs. Your job is the fun part: setting the vision and watching it execute.