Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/chawuciren/cursor-ide-free-trial

πŸš€ A utility tool for Cursor IDE trial.
https://github.com/chawuciren/cursor-ide-free-trial

account-management browser-automation cursor cursor-helper cursor-ide electron

Last synced: 2 months ago
JSON representation

πŸš€ A utility tool for Cursor IDE trial.

Awesome Lists containing this project

README 

        
# πŸš€ Cursor IDE Free Trial



[δΈ­ζ–‡η‰ˆ](README_CN.md)



🎯 Cursor IDE Free Trial is a utility tool designed to help users conveniently experience the trial version of Cursor IDE. This tool primarily addresses machine code verification issues during the trial process and provides streamlined email and account management features.



## ✨ Project Overview



This is an Electron-based utility tool focused on optimizing the Cursor IDE trial experience. Main features include:

- πŸ”‘ Resolving machine code verification issues

- πŸ“§ Providing convenient email service functionality

- πŸ‘€ Simplifying account management process

- ⚑ Optimizing trial experience



⚠️ **Important Note:** If you find Cursor IDE meets your needs during the trial period, we strongly encourage you to purchase the official version for complete service experience.



πŸ–₯️ **Platform Support:**

- βœ… Windows: Fully supported

- 🚧 macOS: Under development

- 🚧 Linux: Under development



## πŸ› οΈ Tech Stack



### πŸ–₯️ Desktop App

- βš›οΈ Electron v33.0.0: Cross-platform desktop application framework

- 🟒 Node.js: Runtime environment

- πŸ“ JavaScript/TypeScript: Primary development languages



### πŸ”§ Local Server

- 🌐 Express.js: Web application framework

- πŸ”„ WebSocket: Real-time communication

- πŸ“„ EJS: Template engine

- πŸ’Ύ SQLite: Local data storage

- πŸ€– Puppeteer: Browser automation

- 🌍 Axios: HTTP client



## πŸ’« Features



- πŸ“¨ Email service integration

- 🎨 Modern user interface

- πŸ‘₯ Account management system

- πŸ”„ Real-time communication support

- πŸ’Ύ Local data persistence

- πŸ€– Browser automation features



## πŸ“¦ Installation Guide



### πŸ’» System Requirements



- Windows 10 or higher (Currently Windows-only)



⚠️ **Note:** Support for macOS and Linux platforms is under development



### πŸ”§ Installation Steps



1. πŸ“₯ Download:

   - Download the latest version zip package from the release page (e.g., `v1.2.0-win64.zip`)



2. βš™οΈ Installation:

   - Extract the downloaded zip package to your desired directory

   - Run `AI_IDE_Free_Trial.exe` with administrator privileges



### πŸ“ Usage Guide



1. βš™οΈ Basic Configuration:

   After running the software, go to the "Settings" tab and configure the following:



   **🌐 Proxy Settings:**

   - Check "Enable Proxy"

   - Fill in your proxy host and port information



   **πŸ“§ Email Settings:**

   - Check "Use Proxy"

   - Select "Public API Pool" as type

   - Set API endpoint to: `https://emailapi.goaiwork.online`

   - Keep other email settings as default



   **πŸ“ Registration Settings:**

   - Select "cursor" as registration type



   **🌍 Browser Settings:**

   - Check "Enable Proxy"

   - Recommended to enable "Check Browser Fingerprint"

   - Not recommended to enable "Headless Mode" (may cause verification code issues)

   - If you have a fingerprint browser, you can specify its executable path



2. πŸ” Authorization:

   To use the convenient public API pool for email services, you need to obtain authorization first:

   - Get your machine code

   - Apply for authorization through one of the following methods:

     - Discord: [Join our Discord community](https://discord.gg/wTjdGqNP)

     - WeChat: Join our WeChat group

       

       ![WeChat Group](doc/wechat.png)

   - Provide your machine code to administrators and wait for authorization



3. πŸ”„ Usage Flow:

   - Click "Save Settings" after configuration

   - You can use the "One-Click Account Switch" tab for quick account switching

   - Or perform operations step by step in other tabs:

     - **πŸ“§ Email Binding**: Generate new email account and bind email routing

     - **πŸ‘€ Account Registration**: Register account using the bound email

     - **πŸ”‘ Account Login**: Login with registered account and switch IDE account



### Development Setup



```bash

# Clone the repository

git clone [repository URL]



# Install main app dependencies

npm install



# Install server dependencies

cd server

npm install

cd ..



# Start development environment

npm run dev



# Start in Windows environment

npm run dev:win



# Build the application

npm run build

```



Node.js Environment Configuration for Packaging:

   - Download Node.js runtime for your platform

   - Root directory configuration:

     - Windows: Name Node.js environment folder as `node_win32`

     - macOS: Name Node.js environment folder as `node_darwin`

     - Linux: Name Node.js environment folder as `node_linux`

   - Server directory configuration:

     - Copy current system's Node.js environment to `server` directory, rename as `node`

     - Example: On Windows, copy `node_win32` to `server/node`



Directory Structure Example:

   ```

   root/

   β”œβ”€β”€ node_win32/     # Windows Node.js environment

   β”œβ”€β”€ node_darwin/    # macOS Node.js environment

   β”œβ”€β”€ node_linux/     # Linux Node.js environment

   └── server/

       └── node/       # Current system's Node.js environment (for debugging)

   ```



## Project Structure



```

.

β”œβ”€β”€ src/            # Desktop app source code

β”œβ”€β”€ public/         # Static resources

β”œβ”€β”€ views/          # View files

β”œβ”€β”€ server/         # Local server

β”‚   β”œβ”€β”€ api/        # API routes

β”‚   β”œβ”€β”€ flows/      # Business logic

β”‚   β”œβ”€β”€ utils/      # Utility functions

β”‚   β”œβ”€β”€ node/       # Current system's Node.js environment (for debugging)

β”‚   β”œβ”€β”€ app.js      # Application configuration

β”‚   └── server.js   # Server entry point

β”œβ”€β”€ scripts/        # Build and utility scripts

β”œβ”€β”€ extensions/     # Plugin system

β”œβ”€β”€ release/        # Build output directory

β”œβ”€β”€ node_win32/     # Windows Node.js environment

β”œβ”€β”€ node_darwin/    # macOS Node.js environment

└── node_linux/     # Linux Node.js environment

```



## Dependencies



### Desktop App

- [Electron](https://www.electronjs.org/): For building cross-platform desktop applications

- [Node.js](https://nodejs.org/): JavaScript runtime

- [electron-builder](https://www.electron.build/): Electron application packaging tool



### Server

- [Express](https://expressjs.com/): Web application framework

- [ws](https://github.com/websockets/ws): WebSocket client and server

- [SQLite3](https://github.com/TryGhost/node-sqlite3): SQLite database

- [Puppeteer](https://pptr.dev/): Browser automation tool

- [Nodemailer](https://nodemailer.com/): Email sending

- [EJS](https://ejs.co/): Embedded JavaScript templating



## Configuration



### Node.js Environment Configuration

- Runtime requirements: Node.js 14.0.0 or higher

- For development debugging, ensure the `server/node` directory contains the Node.js environment for your current system

- In production, the appropriate Node.js environment (node_win32/node_darwin/node_linux) will be automatically selected based on the user's system



### Server Configuration

- Default port: 3000 (can be modified via startup parameters)

- Development environment: Uses APP_ROOT environment variable

- Production environment: Uses RES_PATH environment variable



## Contributing



Issues and Pull Requests are welcome to help improve the project.



## License



This project is open-sourced under the ISC License.



## Acknowledgments



Thanks to the following open source projects and communities:



- Electron Community

- Node.js Community

- Express.js Community

- SQLite Community

- All project contributors



## Author



Guinea Pig Special Forces



## Version History



- Desktop App: v1.1.6

- Server: v1.1.2