# Swan Cloud Documentation AI Marketing Cloud Platform for Your Business Growth Swan Cloud is an AI marketing platform for building, deploying, and managing AI-driven marketing solutions in secure, on-premise cloud environments. ## What We Offer ### AI Solutions * Custom AI models and pipelines * LLM fine-tuning * Managed Compute Pipelines (MCP) * Retrieval-Augmented Generation (RAG) * Dataset preparation ### Cloud Deployment * Containerized GPU inference * Edge and on-premise infrastructure * Private cloud support * Full data control and compliance ### Web3 Ready * Blockchain integration * Community management tools * Blockchain-based payments * RPC services and DeFi solutions ## Core Products * **Future Citizen**: AI agents for online promotions and social engagement ([Try Future Citizen](https://app.futurecitizen.ai/)) * **Xpress**: AI-powered X/Twitter reply assistant ([Try Xpress](https://xpress.futurecitizen.ai/)) * **Swan Provider**: Become a compute or storage provider and earn rewards * **Swan IPFS Storage**: Decentralized file storage using IPFS ## Get Started * [Introduction](https://github.com/filswan/swan-doc/blob/main/getting-started/introduction.md) * [Quickstart](https://github.com/filswan/swan-doc/blob/main/getting-started/quickstart.md) * [Platform Overview](https://github.com/filswan/swan-doc/blob/main/platform-overview/architecture.md) * [Products](https://github.com/filswan/swan-doc/blob/main/products/future-citizen/overview.md) * [Developer Guide](https://github.com/filswan/swan-doc/blob/main/developer/api-reference.md) # Introduction # Quickstart # FAQ # Overview This section provides a high-level view of the Swan Cloud platform, including its architecture, provider ecosystem, security and privacy features, and pricing models. Use these pages to understand the core infrastructure and operational principles behind Swan Cloud. # Architecture # Computing Providers A Computing Provider (CP) is a third-party individual or organization that offers scalable computing resources, which businesses can access on demand over Swan network. These resources include cloud-based compute, storage, platform, and application services. As a resource provider, you can run a **ECP** (Edge Computing Provider) and **FCP** (Fog Computing Provider) to contribute yourcomputing resource. * **ECP (Edge Computing Provider)** specializes in processing data at the source of data generation, using minimal latency setups ideal for real-time applications. This provider handles specific, localized tasks directly on devices at the network’s edge, such as IoT devices. At the current stage, ECP supports the generation of **ZK-Snark proof of Filecoin network**, and more ZK proof types will be gradually supported, such as Aleo, Scroll, starkNet, etc. Check [Install Guideline](https://docs.swanchain.io/bulders/computing-provider/edge-computing-provider-ecp/ecp-setup) here. * **FCP (Fog Computing Provider)** Offers a layered network that extends cloud capabilities to the edge of the network, providing services such as AI model training and deployment. This provider utilizes infrastructure like Kubernetes (K8S) to support scalable, distributed computing tasks. **FCP** will execute tasks assigned by Market Provider, like [Orchestrator](https://orchestrator.swanchain.io/) on the [Swan chain](https://swanchain.io/). Check [Install Guideline](https://docs.swanchain.io/bulders/computing-provider/fog-computing-provider-fcp/computing-provider-setup) here. For the current status of Swan Provider Network, please check here: [https://provider.swanchain.io](https://provider.swanchain.io/overview) ### **Address Types** A CP account has three different wallet addresses to ensure security and separation of responsibilities: * `ownerAddress`: This is the owner account of the CP account. The owner has permission to change account information such as the multi-address, worker address, and beneficiary address. In most situations, the private key of the `ownerAddress` does not need to be present on the server for security reasons. * `workerAddress`: This is the actual working address used for submitting proofs (`submitProof`). It needs to be funded with a certain amount of ETH to pay for gas fees when submitting proofs. * `beneficiaryAddress`: This is the address where all earnings from the CP account will be sent. It is solely used for receiving funds. For security purposes, the private key of the `beneficiaryAddress` should not be stored on the server to maintain isolation. By separating these address, the system ensures that only the necessary `workerAddress` private key is present on the server, while the more sensitive `ownerAddress` and `beneficiaryAddress` private keys are kept separate, enhancing the overall security of the system. [**More Details**](https://docs.swanchain.io/bulders/computing-provider) # Security & Privacy # Pricing # Products Overview ## Why Teams Choose Swan Cloud * **AI-Driven Marketing Automation**: Automate social engagement with AI-generated comments, tweets, and personalized interactions — powered by advanced LLM and RAG technology. * **Cloud-Native & On-Premise Flexibility**: Deploy in edge or on-premise environments to meet your compliance, data privacy, and performance needs — with full control over your infrastructure. * **Web3-Ready Infrastructure**: Built-in support for decentralized compute, IPFS storage, and blockchain-based incentive systems — designed for growth in the next internet. ## Product Highlights ### [Future Citizen](/products/overview/future-citizen) **AI agent for online promotions**\ Hire or build AI-powered agents to promote your products across social platforms, forums, and digital communities.\ [Try Future Citizen Now](https://app.futurecitizen.ai/) ### [Xpress](/products/overview/xpress) **X/Twitter AI Reply Assistant**\ Automatically generate replies that match your tone, brand voice, and tweet style—perfect for community engagement and social growth.\ [Launch Xpress Now](https://xpress.futurecitizen.ai/) *** * [Swan Provider](/products/overview/overview): Become a compute or storage provider and earn rewards. * [Swan IPFS Storage](/products/overview/overview-1): Decentralized file storage using IPFS. * [Lagrange](https://github.com/filswan/swan-doc/blob/main/products/lagrange-dao/overview.md): Web3-oriented source code management and governance. # Future Citizen # Xpress # Swan Provider Swan Provider is the backbone of the Swan Cloud decentralized computing and storage network. Providers contribute compute and storage resources, enabling scalable, distributed AI and storage services for the platform's users and products. ## What is a Swan Provider? A Swan Provider is an independent node operator who supplies computing power, storage capacity, or both to the Swan Cloud network. Providers help power AI marketing agents, decentralized applications, and IPFS-based storage solutions. ## Key Benefits * **Earn Rewards:** Receive compensation for contributing resources to the network. * **Support Decentralized AI:** Enable AI-powered agents and applications to run in a distributed, censorship-resistant environment. * **Flexible Participation:** Operate as a compute provider, storage provider, or both. * **Seamless Integration:** Easily connect with Swan Cloud APIs and management tools. ## Use Cases * Powering Future Citizen AI agents for social media campaigns * Providing storage for Swan IPFS Storage users * Supporting decentralized applications and data marketplaces ## Next Steps * [Provider Setup Guide](https://docs.swanchain.io/bulders/computing-provider) * [Provider FAQ](https://docs.swanchain.io/bulders/computing-provider/faq) # Swan IPFS Storage [Swan IPFS Storage](https://swanipfs.com/)(formerly Multichain Storage), developed by the Swan Network, is a new kind of storage service that works with different blockchain networks. It transcends traditional cloud storage by using smart contracts for enhanced security, reminiscent of an [S3 storage gateway](https://aws.amazon.com/storagegateway/file/s3/) but with the added benefit of decentralization. ## Why Choose Swan IPFS Storage? Swan IPFS Storage offers several advantages over traditional cloud services, such as: * **Decentralization:** Swan IPFS Storage eliminates the need for intermediaries and third-party providers, giving users full control and ownership over their data. Swan IPFS Storage also prevents censorship and tampering by ensuring that files are replicated and verified across multiple nodes. * **Interoperability:**Swan IPFS Storage supports multiple blockchains, including Ethereum, Polygon and more. This means that users can access their files from any chain they prefer, without being locked into a single platform or network. * **Cost-efficiency:** Swan IPFS Storage reduces the cost of storage by utilizing the spare capacity of existing nodes. Swan IPFS Storage also optimizes the storage allocation and distribution based on the demand and supply of each chain. * **Scalability:** Swan IPFS Storage can handle large volumes of data and traffic without compromising speed or quality. Swan IPFS Storage also adapts to the changing conditions of each chain, such as congestion, fees, and latency. ## What Can You Store with Swan IPFS Storage? Swan IPFS Storage can store any type of file that can be hosted on a website, such as: * Images, videos, audio, and other media formats * PDFs, documents, spreadsheets, and other office files * JSON, XML, CSV, and other data formats * HTML, CSS, JavaScript, and other web development languages Try it here: [https://swanipfs.com](https://swanipfs.com/) ## Use Cases * Storing campaign assets for Future Citizen AI agents * Decentralized backup and archival * Data sharing for distributed applications See the [User Guide](https://docs.swanchain.io/bulders/app-developer/store-and-retrieve-a-file-with-swan-storage) to get started. # Lagrange Web3 HuggingFace ​[Lagrange](https://lagrange.computer) is a decentralized Web3 platform for natural language processing (NLP) development and deployment, built on Swan Chain computing network. It aims to provide a more cost-effective, secure, and interoperable alternative to centralized cloud services like AWS.Lagrange serves as a decentralized version of Hugging Face, leveraging the decentralized computing resources from Swan Chain and utilizing multichain.storage as the decentralized storage layer to ensure the persistence of important data.
*Learn more about Lagrange in*[ *its documentation*](https://docs.lagrangedao.org/)*.*​ [Lagrange](https://lagrange.computer) leverages the advantages of [Swan Chain](https://swanchain.io/), such as: * **Cost-Effective:** By utilizing decentralized resources, Lagrange reduces operational costs compared to traditional cloud services. * **Security:** Ensures data integrity and security through decentralized storage and processing. * **Interoperability:** Compatible with various blockchain networks and computing providers, enhancing flexibility and scalability. * **Efficiency:** Facilitates efficient NLP model training and deployment using distributed computing power. Let’s explore some of the [Spaces](https://lagrange.computer/spaces) built by Lagrange community across categories like AI, gaming, blockchain, and tools. ## **Awesome Spaces** **AI Agent** Explore the capabilities of AI agents using Lagrange technology for advanced machine learning applications * ​[**Eliza-SwanChain**](https://lagrange.computer/spaces/0x231fe9090f4d45413474BDE53a1a0A3Bd5C0ef03/Eliza-swanchain/app)**:** An AI agent using Eliza framework that can answer all questions related to Swan Chain **AI and Creative Spaces** Harness cutting-edge AI models to generate content and boost your creative projects. * ​[**MusicGen**](https://lagrange.computer/spaces/0x231fe9090f4d45413474BDE53a1a0A3Bd5C0ef03/MusicGen/app): Create original music tracks using simple text prompts. * ​[**Stable Diffusion**](https://lagrange.computer/spaces/0x231fe9090f4d45413474BDE53a1a0A3Bd5C0ef03/Stable-Diffusion-Base-LoRA/app): Transform text descriptions into stunning AI-generated images. * ​[**Text-to-Speech**](https://lagrange.computer/spaces/0x231fe9090f4d45413474BDE53a1a0A3Bd5C0ef03/Text-to-Speech/app): Convert written text into natural-sounding speech effortlessly. * ​[**ComfyUI**](https://lagrange.computer/spaces/0x231fe9090f4d45413474BDE53a1a0A3Bd5C0ef03/ComfyUI/app): Streamline AI image generation with an intuitive graphical interface. * ​[**Llama3-8B-LLM-Chat**](https://lagrange.computer/spaces/0x231fe9090f4d45413474BDE53a1a0A3Bd5C0ef03/Llama3-8B-LLM-Chat/app)**:** Meta’s Llama 3, the next iteration of the open-access Llama family. **Gaming Spaces** Relive classic gaming experiences and challenge yourself with timeless favorites. * ​[**Tetris**](https://lagrange.computer/spaces/0x231fe9090f4d45413474BDE53a1a0A3Bd5C0ef03/tetris/app): Test your spatial skills with this iconic block-stacking puzzle. * ​[**Super Mario**](https://lagrange.computer/spaces/0x231fe9090f4d45413474BDE53a1a0A3Bd5C0ef03/Mario/app): Embark on a nostalgic adventure with gaming's most famous plumber. * ​[**Pac-Man**](https://lagrange.computer/spaces/0x231fe9090f4d45413474BDE53a1a0A3Bd5C0ef03/pac-man/app): Navigate mazes and outmaneuver ghosts in this beloved arcade classic. * ​[**2048**](https://lagrange.computer/spaces/0x231fe9090f4d45413474BDE53a1a0A3Bd5C0ef03/2048/app): Slide numbered tiles and aim for the elusive 2048 in this addictive challenge. **Blockchain Spaces** Explore and interact with decentralized technologies using these powerful tools. * ​[**Chainnode-RPC**](https://lagrange.computer/spaces/0x231fe9090f4d45413474BDE53a1a0A3Bd5C0ef03/chainnode-rpc/app): Access and analyze blockchain data with this comprehensive RPC interface. * ​[**Uniswap**](https://lagrange.computer/spaces/0x231fe9090f4d45413474BDE53a1a0A3Bd5C0ef03/uniswap/app): Experience decentralized trading on the Ethereum blockchain. **Development Tools** Enhance your coding workflow with these essential development utilities. * ​[**Terminal**](https://lagrange.computer/spaces/0x231fe9090f4d45413474BDE53a1a0A3Bd5C0ef03/Terminal/app): Access a versatile command-line interface directly in your browser. * ​[**JSON-View**](https://lagrange.computer/spaces/0x231fe9090f4d45413474BDE53a1a0A3Bd5C0ef03/Json-view/app): Visualize and interact with JSON data in a user-friendly web environment. * ​[**Jupyter**](https://lagrange.computer/spaces/0x231fe9090f4d45413474BDE53a1a0A3Bd5C0ef03/Jupyter-Labs/app): Develop, document, and execute code in an interactive notebook interface. *Exploring more models from the reporitory* [*here*](https://github.com/swanchain/awesome-swanchain)*.* #### Contribute to Lagrange Have an idea for a new space? We welcome contributions from our community! * ​[Fork and build your first Space](https://docs.lagrangedao.org/spaces/fork-space)​ * ​[Explore our model repository](https://github.com/swanchain/awesome-swanchain)​ Join us in expanding the Lagrange ecosystem and share your innovations with developers worldwide. # Overview This section provides resources for developers building on Swan Cloud. Find API references, authentication guides, integration instructions, and practical code examples to accelerate your development. # API Reference # Authentication # Integration # Examples # Support # Contribute # Changelog # Protocol Stack This section contains legacy and advanced documentation on the underlying decentralized infrastructure, consensus mechanisms, economic layers, and governance models that have powered Swan Cloud and its ecosystem. # Contact Us Find information on how to reach the Swan Cloud team, join our communities, or explore business partnership opportunities. See the subpages for social accounts and contact details. # FAQ # QuickStarts