Skip to content

Commit 33922e8

Browse files
Kylejeong2Kylejeong2
committed
init
0 parents  commit 33922e8

File tree

127 files changed

+38206
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

127 files changed

+38206
-0
lines changed

‎.gitignore

Lines changed: 126 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,126 @@
1+
# Dependencies
2+
node_modules/
3+
.pnpm-store/
4+
pnpm-lock.yaml
5+
6+
# Build outputs
7+
dist/
8+
build/
9+
out/
10+
.next/
11+
.nuxt/
12+
.output/
13+
14+
# Logs
15+
*.log
16+
logs/
17+
npm-debug.log*
18+
yarn-debug.log*
19+
yarn-error.log*
20+
pnpm-debug.log*
21+
lerna-debug.log*
22+
23+
# Runtime data
24+
pids/
25+
*.pid
26+
*.seed
27+
*.pid.lock
28+
29+
# Coverage directory used by tools like istanbul
30+
coverage/
31+
*.lcov
32+
.nyc_output/
33+
34+
# Instrumentation
35+
lib-cov/
36+
37+
# Grunt intermediate storage
38+
.grunt/
39+
40+
# Bower dependency directory
41+
bower_components/
42+
43+
# Node-waf configuration
44+
.lock-wscript
45+
46+
# Compiled binary addons
47+
build/Release
48+
49+
# Dependency directories
50+
jspm_packages/
51+
52+
# TypeScript cache
53+
*.tsbuildinfo
54+
55+
# Optional npm cache directory
56+
.npm
57+
58+
# Optional eslint cache
59+
.eslintcache
60+
61+
# Optional REPL history
62+
.node_repl_history
63+
64+
# Output of 'npm pack'
65+
*.tgz
66+
67+
# Yarn Integrity file
68+
.yarn-integrity
69+
70+
# dotenv environment variables file
71+
.env
72+
.env.local
73+
.env.development.local
74+
.env.test.local
75+
.env.production.local
76+
77+
# Parcel-bundler cache
78+
.cache/
79+
.parcel-cache/
80+
81+
# Next.js build output
82+
.next/
83+
84+
# Nuxt.js build / generate output
85+
.nuxt/
86+
dist/
87+
88+
# Vuepress build output
89+
.vuepress/dist
90+
91+
# Serverless directories
92+
.serverless/
93+
94+
# FuseBox cache
95+
.fusebox/
96+
97+
# DynamoDB Local files
98+
.dynamodb/
99+
100+
# TernJS port file
101+
.tern-port
102+
103+
# Stores VSCode versions used for testing VSCode extensions
104+
.vscode-test/
105+
106+
# yarn v2
107+
.yarn/cache
108+
.yarn/unplugged
109+
.yarn/build-state.yml
110+
.yarn/install-state.gz
111+
.pnp.*
112+
113+
# MacOS
114+
.DS_Store
115+
116+
# IDE
117+
.vscode/
118+
.idea/
119+
120+
# Temporary files
121+
tmp/
122+
temp/
123+
124+
# Test artifacts
125+
test-results/
126+
playwright-report/

‎.prettierignore

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
coverage/
2+
dist/
3+
build/
4+
out/
5+
public/
6+
pnpm-lock.yaml
7+
pnpm-workspace.yaml
8+
*.min.js
9+
*.min.css
10+
.next/
11+
.nuxt/
12+
node_modules/
13+
.pnpm-store/

‎.prettierrc.json

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
{
2+
"semi": true,
3+
"singleQuote": true,
4+
"tabWidth": 2,
5+
"trailingComma": "es5",
6+
"printWidth": 80,
7+
"arrowParens": "avoid",
8+
"endOfLine": "lf",
9+
"bracketSpacing": true,
10+
"bracketSameLine": false,
11+
"quoteProps": "as-needed"
12+
}

‎LICENSE

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
Copyright 2025 Browserbase, Inc.
2+
3+
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
4+
5+
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
6+
7+
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

‎README.md

Lines changed: 133 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,133 @@
1+
# Browserbase Integrations
2+
3+
**A comprehensive monorepo of production-ready integrations for Browserbase - the headless browser infrastructure for AI agents and web automation.**
4+
5+
Browserbase provides scalable, reliable browser infrastructure that powers the next generation of AI applications. This repository contains officially maintained integrations with popular frameworks, libraries, and platforms to help you build powerful web automation and AI agent solutions.
6+
7+
## 🚀 What is Browserbase?
8+
9+
Browserbase is headless browser infrastructure designed specifically for AI agents and web automation at scale. It provides:
10+
11+
- **Browser sessions** that scale automatically
12+
- **Anti-detection capabilities** to bypass bot protection
13+
- **Visual debugging** with session recordings and screenshots
14+
- **Global infrastructure** for low-latency access worldwide
15+
- **Stealth technology** to ensure reliable web interaction
16+
17+
## 📦 Available Integrations
18+
19+
Our integrations are organized by platform and use case, each with comprehensive documentation and examples:
20+
21+
### 🤖 AI Agent Frameworks
22+
23+
#### [**CrewAI Integration**](./examples/integrations/crewai/README.md)
24+
Enable your CrewAI agents to browse the web like humans with the `BrowserbaseLoadTool`. Perfect for creating intelligent agent crews that need to gather real-time web data, extract content from complex pages, and interact with modern web applications.
25+
26+
**Key Features:**
27+
- Extract text from JavaScript-heavy websites
28+
- Capture screenshots and visual content
29+
- Bypass anti-bot mechanisms
30+
- Seamless integration with CrewAI's tool ecosystem
31+
32+
#### [**AgentKit Integration**](./examples/integrations/agentkit/)
33+
Powerful integrations for AgentKit workflows with both Browserbase and Stagehand implementations:
34+
35+
- **[Browserbase Implementation](./examples/integrations/agentkit/browserbase/README.md)** - Direct Browserbase integration for AgentKit
36+
- **[Stagehand Implementation](./examples/integrations/agentkit/stagehand/README.md)** - AI-powered web automation using Stagehand
37+
38+
#### [**LangChain Integration**](./examples/integrations/langchain/README.md)
39+
Integrate Browserbase with LangChain's ecosystem for advanced AI applications. Build chains that can browse, extract, and interact with web content as part of larger AI workflows.
40+
41+
#### [**Browser-Use Integration**](./examples/integrations/browser-use/README.md)
42+
Streamlined browser automation for AI applications with a focus on simplicity and reliability.
43+
44+
### 🏗️ Development & Deployment Platforms
45+
46+
#### [**Vercel AI Integration**](./examples/integrations/vercel/README.md)
47+
Enhance your Vercel applications with web-browsing capabilities. Build Generative User Interfaces that can access real-time web data and create dynamic, AI-powered experiences.
48+
49+
**Examples Include:**
50+
- **BrowseGPT** - A chat interface with real-time web search capabilities
51+
- **Vercel + Puppeteer** - Server-side browser automation on Fluid Compute
52+
53+
### 💳 E-commerce & Payments
54+
55+
#### [**Stripe Integration**](./examples/integrations/stripe/README.md)
56+
**Agentic Credit Card Automation** - Create virtual cards with Stripe Issuing and automate online purchases with Browserbase. Perfect for programmatic commerce, testing payment flows, and building AI shopping agents.
57+
58+
**Capabilities:**
59+
- Create virtual cards with spending controls
60+
- Automate secure online purchases
61+
- Available in Node.js, Python, and Stagehand implementations
62+
- Production-ready with comprehensive examples
63+
64+
### 📊 Evaluation & Testing
65+
66+
#### [**Braintrust Integration**](./examples/integrations/braintrust/)
67+
Integrate Browserbase with Braintrust for evaluation and testing of AI agent performance in web environments. Monitor, measure, and improve your browser automation workflows.
68+
69+
## 🏗️ Monorepo Structure
70+
71+
```
72+
integrations/
73+
├── examples/
74+
| |
75+
│ └── community/ # WIP
76+
│ └── integrations/
77+
│ ├── crewai/ # CrewAI framework integration
78+
│ ├── vercel/ # Vercel AI SDK integration
79+
│ ├── stripe/ # Stripe Issuing + automation
80+
│ ├── langchain/ # LangChain framework integration
81+
│ ├── browser-use/ # Simplified browser automation
82+
│ ├── braintrust/ # Evaluation and testing tools
83+
│ └── agentkit/ # AgentKit implementations
84+
└── README.md # This file
85+
```
86+
87+
## 🚀 Getting Started
88+
89+
1. **Choose your integration** based on your framework or use case
90+
2. **Navigate to the specific integration directory** for detailed setup instructions
91+
3. **Follow the README** in each integration for environment setup and examples
92+
4. **Review the code samples** to understand implementation patterns
93+
94+
Each integration includes:
95+
- ✅ Complete setup instructions
96+
- ✅ Environment configuration guides
97+
- ✅ Working code examples
98+
- ✅ Best practices and tips
99+
- ✅ Troubleshooting guides
100+
101+
## 🔧 Prerequisites
102+
103+
Most integrations require:
104+
- A [Browserbase account](https://browserbase.com) and API key
105+
- Node.js 18+ or Python 3.8+ (depending on implementation)
106+
- Framework-specific dependencies (detailed in each integration)
107+
108+
## 📖 Documentation
109+
110+
For comprehensive documentation, tutorials, and API references, visit:
111+
112+
**🔗 [Official Browserbase Documentation](https://docs.browserbase.com)**
113+
114+
## 🤝 Community & Support
115+
116+
### Get Help
117+
- **📧 Email Support**: [[email protected]](mailto:[email protected])
118+
- **📚 Documentation**: [docs.browserbase.com](https://docs.browserbase.com)
119+
120+
### Contributing
121+
We welcome contributions! Each integration has its own contribution guidelines. Feel free to:
122+
- Report bugs and request features
123+
- Submit pull requests with improvements
124+
- Share your own integration examples
125+
- Help improve documentation
126+
127+
## 📄 License
128+
129+
This project is licensed under the MIT License. See individual integration directories for any additional licensing information.
130+
131+
---
132+
133+
**Built with ❤️ by the Browserbase team**

‎eslint.config.js

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
import js from '@eslint/js';
2+
import globals from 'globals';
3+
import tseslint from 'typescript-eslint';
4+
import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended';
5+
6+
/** @type {import('eslint').Linter.Config[]} */
7+
export default [
8+
{
9+
ignores: [
10+
'coverage/**',
11+
'**/dist/**',
12+
'**/build/**',
13+
'**/out/**',
14+
'**/public/**',
15+
'pnpm-lock.yaml',
16+
'pnpm-workspace.yaml',
17+
'**/node_modules/**',
18+
'**/.pnpm-store/**',
19+
'**/*.min.js',
20+
'**/*.min.css',
21+
'**/.next/**',
22+
'**/.nuxt/**',
23+
],
24+
},
25+
js.configs.recommended,
26+
...tseslint.configs.recommended,
27+
{
28+
languageOptions: {
29+
globals: {
30+
...globals.browser,
31+
...globals.node,
32+
...globals.es2021,
33+
},
34+
},
35+
},
36+
{
37+
files: ['**/*.{js,mjs,cjs,ts,tsx}'],
38+
rules: {
39+
'@typescript-eslint/no-unused-vars': [
40+
'error',
41+
{ argsIgnorePattern: '^_' },
42+
],
43+
'@typescript-eslint/no-explicit-any': 'warn',
44+
'@typescript-eslint/no-non-null-assertion': 'warn',
45+
'prefer-const': 'error',
46+
'no-var': 'error',
47+
},
48+
},
49+
eslintPluginPrettierRecommended,
50+
];

‎examples/community/README.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# WIP
2+
3+
For community integrations

0 commit comments

Comments
 (0)