agentis


Nameagentis JSON
Version 1.2.7 PyPI version JSON
download
home_pagehttps://agentislabs.ai
SummaryA Python toolkit for Solana agents
upload_time2024-12-31 18:58:01
maintainerNone
docs_urlNone
authorMuhammed Talha Korkmaz
requires_python<3.13,>=3.8
licenseMIT
keywords solana sdk blockchain tools
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Agentis Framework

A comprehensive toolkit for Solana blockchain interactions, offering seamless integration of DeFi operations, token management, and AI-powered automation.

## Core Capabilities

### Token Management 🪙
- Execute SOL and SPL token transfers
- Monitor wallet balances
- Participate in SOL staking
- Create custom tokens
- Access development funds via faucet
- Manage token accounts (burn/close operations)
- Perform bulk token account maintenance

### DeFi Operations 💱
- Seamless Jupiter DEX integration
- Execute token swaps with configurable slippage
- Access direct routing capabilities
- Interface with Raydium liquidity pools

### Yield Generation 🏦
- Access Lulo lending protocols
- Earn passive income on idle assets

### AI Integration 🔗
- Leverage LangChain's intelligent tools
- Automate blockchain interactions
- Access comprehensive tooling for financial operations

### Network Analytics 📈
- Monitor Solana network performance
- Track real-time TPS (Transactions Per Second)

### Token Intelligence 📊
- Retrieve token information via symbol
- Access token data through address lookup

### Token Launch Tools 🚀
- Deploy Pump & Fun tokens
- Customize token parameters

### Liquidity Management 🏦
- Configure and deploy Meteora DLMM pools
- Fine-tune pool parameters

## Getting Started

### Setup
```bash
pip install agentis
```

### Basic Configuration
```python
from agentis import SolanaAgentKit, create_solana_tools

# Initialize framework
agent = SolanaAgentKit(
    private_key="your-base58-private-key",
    rpc_url="https://api.mainnet-beta.solana.com",
    openai_key="your-openai-api-key"
)

# Set up AI tools
tools = create_solana_tools(agent)
```

## Implementation Examples

### Price Discovery
```python
from agentis import SolanaAgentKit

async def main():
    agent = SolanaAgentKit(
        private_key="your-base58-private-key",
        rpc_url="https://api.mainnet-beta.solana.com",
        openai_key="your-openai-api-key"
    )

    price = await agent.fetch_price("FKMKctiJnbZKL16pCmR7ig6bvjcMJffuUMjB97YD7LJs")
    print(f"Current Price: {price} SOL")

import asyncio
asyncio.run(main())
```

### Token Exchange
```python
from agentis import SolanaAgentKit
from solders.pubkey import Pubkey

async def main():
    agent = SolanaAgentKit(
        private_key="your-base58-private-key",
        rpc_url="https://api.mainnet-beta.solana.com",
        openai_key="your-openai-api-key"
    )

    tx_sig = await agent.trade(
        agent,
        output_mint=Pubkey.from_string("target-token-mint"),
        input_amount=100,
        input_mint=Pubkey.from_string("source-token-mint"),
        slippage_bps=300  # 3% slippage tolerance
    )

import asyncio
asyncio.run(main())
```

### Asset Lending
```python
from agentis import SolanaAgentKit

async def main():
    agent = SolanaAgentKit(
        private_key="your-base58-private-key",
        rpc_url="https://api.mainnet-beta.solana.com",
        openai_key="your-openai-api-key"
    )
    
    tx_sig = await agent.lend_assets(amount=100)

import asyncio
asyncio.run(main())
```

### SOL Staking
```python
from agentis import SolanaAgentKit

async def main():
    agent = SolanaAgentKit(
        private_key="your-base58-private-key",
        rpc_url="https://api.mainnet-beta.solana.com",
        openai_key="your-openai-api-key"
    )

    tx_sig = await agent.stake(amount=1)  # Stakes 1 SOL

import asyncio
asyncio.run(main())
```

### Development Fund Access
```python
from agentis import SolanaAgentKit

async def main():
    agent = SolanaAgentKit(
        private_key="your-base58-private-key",
        rpc_url="https://api.mainnet-beta.solana.com",
        openai_key="your-openai-api-key"
    )

    result = await agent.request_faucet_funds()
    print(result)

import asyncio
asyncio.run(main())
```

### Network Performance Monitoring
```python
from agentis import SolanaAgentKit

async def main():
    agent = SolanaAgentKit(
        private_key="your-base58-private-key",
        rpc_url="https://api.mainnet-beta.solana.com",
        openai_key="your-openai-api-key"
    )

    current_tps = await agent.get_tps()
    print(f"Network TPS: {current_tps}")

import asyncio
asyncio.run(main())
```

### Token Data Retrieval
```python
from agentis import SolanaAgentKit

async def main():
    agent = SolanaAgentKit(
        private_key="your-base58-private-key",
        rpc_url="https://api.mainnet-beta.solana.com",
        openai_key="your-openai-api-key"
    )

    # By symbol
    sol_data = await agent.get_token_data_by_ticker("SOL")
    print(sol_data)

    # By address
    token_data = await agent.get_token_data_by_address("token-mint-address")
    print(token_data)

import asyncio
asyncio.run(main())
```

### Token Launch
```python
from agentis import SolanaAgentKit
from agentis.types import PumpfunTokenOptions

async def main():
    agent = SolanaAgentKit(
        private_key="your-base58-private-key",
        rpc_url="https://api.mainnet-beta.solana.com",
        openai_key="your-openai-api-key"
    )

    options = PumpfunTokenOptions()
    result = await agent.launch_pump_fun_token(
        token_name="MyToken",
        token_ticker="MTK",
        description="Example token description",
        image_url="https://example.com/token.png",
        options=options
    )
    print(result)

import asyncio
asyncio.run(main())
```

### DLMM Pool Creation
```python
from agentis import SolanaAgentKit
from solders.pubkey import Pubkey
from agentis.utils.meteora_dlmm.types import ActivationType

async def main():
    agent = SolanaAgentKit(
        private_key="your-base58-private-key",
        rpc_url="https://api.mainnet-beta.solana.com",
        openai_key="your-openai-api-key"
    )

    result = await agent.create_meteora_dlmm_pool(
        bin_step=1,
        token_a_mint=Pubkey.from_string("token-a-mint"),
        token_b_mint=Pubkey.from_string("token-b-mint"),
        initial_price=1.0,
        price_rounding_up=True,
        fee_bps=30,
        activation_type=ActivationType.Timestamp,
        has_alpha_vault=True,
        activation_point=None
    )
    print(result)

import asyncio
asyncio.run(main())
```

## Core Functions Reference

### Asset Operations
- `transfer()`: Execute token transfers
- `trade()`: Perform token swaps
- `get_balance()`: Check wallet balances
- `lend_asset()`: Lend assets via Lulo
- `stake()`: Participate in SOL staking
- `request_faucet_funds()`: Access development funds
- `deploy_token()`: Create new tokens
- `fetch_price()`: Retrieve token prices

### Analytics & Data
- `get_tps()`: Monitor network performance
- `get_token_data_by_ticker()`: Token lookup by symbol
- `get_token_data_by_address()`: Token lookup by address

### Advanced Features
- `launch_pump_fun_token()`: Deploy custom tokens
- `create_meteora_dlmm_pool()`: Configure liquidity pools
- `buy_with_raydium()`: Execute Raydium purchases
- `sell_with_raydium()`: Execute Raydium sales
- `burn_and_close_accounts()`: Manage token accounts
- `multiple_burn_and_close_accounts()`: Bulk account management

## Technical Requirements

Essential dependencies:
- solana-py
- spl-token-py

## Community Participation

We welcome contributions! Feel free to submit pull requests.

## Licensing

ISC License

## Security Advisory

Exercise caution with private keys and ensure secure implementation practices.


            

Raw data

            {
    "_id": null,
    "home_page": "https://agentislabs.ai",
    "name": "agentis",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<3.13,>=3.8",
    "maintainer_email": null,
    "keywords": "solana, sdk, blockchain, tools",
    "author": "Muhammed Talha Korkmaz",
    "author_email": "kriptovekediler@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/2d/c1/34391649460bed921e9dcbb9eb5579caf9fce7ca2c04d927a2e12ef78f9b/agentis-1.2.7.tar.gz",
    "platform": null,
    "description": "# Agentis Framework\n\nA comprehensive toolkit for Solana blockchain interactions, offering seamless integration of DeFi operations, token management, and AI-powered automation.\n\n## Core Capabilities\n\n### Token Management \ud83e\ude99\n- Execute SOL and SPL token transfers\n- Monitor wallet balances\n- Participate in SOL staking\n- Create custom tokens\n- Access development funds via faucet\n- Manage token accounts (burn/close operations)\n- Perform bulk token account maintenance\n\n### DeFi Operations \ud83d\udcb1\n- Seamless Jupiter DEX integration\n- Execute token swaps with configurable slippage\n- Access direct routing capabilities\n- Interface with Raydium liquidity pools\n\n### Yield Generation \ud83c\udfe6\n- Access Lulo lending protocols\n- Earn passive income on idle assets\n\n### AI Integration \ud83d\udd17\n- Leverage LangChain's intelligent tools\n- Automate blockchain interactions\n- Access comprehensive tooling for financial operations\n\n### Network Analytics \ud83d\udcc8\n- Monitor Solana network performance\n- Track real-time TPS (Transactions Per Second)\n\n### Token Intelligence \ud83d\udcca\n- Retrieve token information via symbol\n- Access token data through address lookup\n\n### Token Launch Tools \ud83d\ude80\n- Deploy Pump & Fun tokens\n- Customize token parameters\n\n### Liquidity Management \ud83c\udfe6\n- Configure and deploy Meteora DLMM pools\n- Fine-tune pool parameters\n\n## Getting Started\n\n### Setup\n```bash\npip install agentis\n```\n\n### Basic Configuration\n```python\nfrom agentis import SolanaAgentKit, create_solana_tools\n\n# Initialize framework\nagent = SolanaAgentKit(\n    private_key=\"your-base58-private-key\",\n    rpc_url=\"https://api.mainnet-beta.solana.com\",\n    openai_key=\"your-openai-api-key\"\n)\n\n# Set up AI tools\ntools = create_solana_tools(agent)\n```\n\n## Implementation Examples\n\n### Price Discovery\n```python\nfrom agentis import SolanaAgentKit\n\nasync def main():\n    agent = SolanaAgentKit(\n        private_key=\"your-base58-private-key\",\n        rpc_url=\"https://api.mainnet-beta.solana.com\",\n        openai_key=\"your-openai-api-key\"\n    )\n\n    price = await agent.fetch_price(\"FKMKctiJnbZKL16pCmR7ig6bvjcMJffuUMjB97YD7LJs\")\n    print(f\"Current Price: {price} SOL\")\n\nimport asyncio\nasyncio.run(main())\n```\n\n### Token Exchange\n```python\nfrom agentis import SolanaAgentKit\nfrom solders.pubkey import Pubkey\n\nasync def main():\n    agent = SolanaAgentKit(\n        private_key=\"your-base58-private-key\",\n        rpc_url=\"https://api.mainnet-beta.solana.com\",\n        openai_key=\"your-openai-api-key\"\n    )\n\n    tx_sig = await agent.trade(\n        agent,\n        output_mint=Pubkey.from_string(\"target-token-mint\"),\n        input_amount=100,\n        input_mint=Pubkey.from_string(\"source-token-mint\"),\n        slippage_bps=300  # 3% slippage tolerance\n    )\n\nimport asyncio\nasyncio.run(main())\n```\n\n### Asset Lending\n```python\nfrom agentis import SolanaAgentKit\n\nasync def main():\n    agent = SolanaAgentKit(\n        private_key=\"your-base58-private-key\",\n        rpc_url=\"https://api.mainnet-beta.solana.com\",\n        openai_key=\"your-openai-api-key\"\n    )\n    \n    tx_sig = await agent.lend_assets(amount=100)\n\nimport asyncio\nasyncio.run(main())\n```\n\n### SOL Staking\n```python\nfrom agentis import SolanaAgentKit\n\nasync def main():\n    agent = SolanaAgentKit(\n        private_key=\"your-base58-private-key\",\n        rpc_url=\"https://api.mainnet-beta.solana.com\",\n        openai_key=\"your-openai-api-key\"\n    )\n\n    tx_sig = await agent.stake(amount=1)  # Stakes 1 SOL\n\nimport asyncio\nasyncio.run(main())\n```\n\n### Development Fund Access\n```python\nfrom agentis import SolanaAgentKit\n\nasync def main():\n    agent = SolanaAgentKit(\n        private_key=\"your-base58-private-key\",\n        rpc_url=\"https://api.mainnet-beta.solana.com\",\n        openai_key=\"your-openai-api-key\"\n    )\n\n    result = await agent.request_faucet_funds()\n    print(result)\n\nimport asyncio\nasyncio.run(main())\n```\n\n### Network Performance Monitoring\n```python\nfrom agentis import SolanaAgentKit\n\nasync def main():\n    agent = SolanaAgentKit(\n        private_key=\"your-base58-private-key\",\n        rpc_url=\"https://api.mainnet-beta.solana.com\",\n        openai_key=\"your-openai-api-key\"\n    )\n\n    current_tps = await agent.get_tps()\n    print(f\"Network TPS: {current_tps}\")\n\nimport asyncio\nasyncio.run(main())\n```\n\n### Token Data Retrieval\n```python\nfrom agentis import SolanaAgentKit\n\nasync def main():\n    agent = SolanaAgentKit(\n        private_key=\"your-base58-private-key\",\n        rpc_url=\"https://api.mainnet-beta.solana.com\",\n        openai_key=\"your-openai-api-key\"\n    )\n\n    # By symbol\n    sol_data = await agent.get_token_data_by_ticker(\"SOL\")\n    print(sol_data)\n\n    # By address\n    token_data = await agent.get_token_data_by_address(\"token-mint-address\")\n    print(token_data)\n\nimport asyncio\nasyncio.run(main())\n```\n\n### Token Launch\n```python\nfrom agentis import SolanaAgentKit\nfrom agentis.types import PumpfunTokenOptions\n\nasync def main():\n    agent = SolanaAgentKit(\n        private_key=\"your-base58-private-key\",\n        rpc_url=\"https://api.mainnet-beta.solana.com\",\n        openai_key=\"your-openai-api-key\"\n    )\n\n    options = PumpfunTokenOptions()\n    result = await agent.launch_pump_fun_token(\n        token_name=\"MyToken\",\n        token_ticker=\"MTK\",\n        description=\"Example token description\",\n        image_url=\"https://example.com/token.png\",\n        options=options\n    )\n    print(result)\n\nimport asyncio\nasyncio.run(main())\n```\n\n### DLMM Pool Creation\n```python\nfrom agentis import SolanaAgentKit\nfrom solders.pubkey import Pubkey\nfrom agentis.utils.meteora_dlmm.types import ActivationType\n\nasync def main():\n    agent = SolanaAgentKit(\n        private_key=\"your-base58-private-key\",\n        rpc_url=\"https://api.mainnet-beta.solana.com\",\n        openai_key=\"your-openai-api-key\"\n    )\n\n    result = await agent.create_meteora_dlmm_pool(\n        bin_step=1,\n        token_a_mint=Pubkey.from_string(\"token-a-mint\"),\n        token_b_mint=Pubkey.from_string(\"token-b-mint\"),\n        initial_price=1.0,\n        price_rounding_up=True,\n        fee_bps=30,\n        activation_type=ActivationType.Timestamp,\n        has_alpha_vault=True,\n        activation_point=None\n    )\n    print(result)\n\nimport asyncio\nasyncio.run(main())\n```\n\n## Core Functions Reference\n\n### Asset Operations\n- `transfer()`: Execute token transfers\n- `trade()`: Perform token swaps\n- `get_balance()`: Check wallet balances\n- `lend_asset()`: Lend assets via Lulo\n- `stake()`: Participate in SOL staking\n- `request_faucet_funds()`: Access development funds\n- `deploy_token()`: Create new tokens\n- `fetch_price()`: Retrieve token prices\n\n### Analytics & Data\n- `get_tps()`: Monitor network performance\n- `get_token_data_by_ticker()`: Token lookup by symbol\n- `get_token_data_by_address()`: Token lookup by address\n\n### Advanced Features\n- `launch_pump_fun_token()`: Deploy custom tokens\n- `create_meteora_dlmm_pool()`: Configure liquidity pools\n- `buy_with_raydium()`: Execute Raydium purchases\n- `sell_with_raydium()`: Execute Raydium sales\n- `burn_and_close_accounts()`: Manage token accounts\n- `multiple_burn_and_close_accounts()`: Bulk account management\n\n## Technical Requirements\n\nEssential dependencies:\n- solana-py\n- spl-token-py\n\n## Community Participation\n\nWe welcome contributions! Feel free to submit pull requests.\n\n## Licensing\n\nISC License\n\n## Security Advisory\n\nExercise caution with private keys and ensure secure implementation practices.\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A Python toolkit for Solana agents",
    "version": "1.2.7",
    "project_urls": {
        "Homepage": "https://agentislabs.ai",
        "Repository": "https://github.com/Traddoo/Agentis-Framework"
    },
    "split_keywords": [
        "solana",
        " sdk",
        " blockchain",
        " tools"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "102ff7c770e2f962c5b7bdb4786c4366a564e70f8df5e0d5638b556df8bb1128",
                "md5": "87488b574aee9660d57d4b92cd471cdc",
                "sha256": "fb7f74ce9e11a89b9dc4b573c3f8d9fb92c317f499afd0fe0044e34e6eec34e8"
            },
            "downloads": -1,
            "filename": "agentis-1.2.7-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "87488b574aee9660d57d4b92cd471cdc",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<3.13,>=3.8",
            "size": 61246,
            "upload_time": "2024-12-31T18:57:58",
            "upload_time_iso_8601": "2024-12-31T18:57:58.919777Z",
            "url": "https://files.pythonhosted.org/packages/10/2f/f7c770e2f962c5b7bdb4786c4366a564e70f8df5e0d5638b556df8bb1128/agentis-1.2.7-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "2dc134391649460bed921e9dcbb9eb5579caf9fce7ca2c04d927a2e12ef78f9b",
                "md5": "b452d583a808bdd7244b500bb8bb35b1",
                "sha256": "bfb32fc9f19c55ae0346fe2a0bdb8cebcea9d4f3e7a358e4bca21cf6044af336"
            },
            "downloads": -1,
            "filename": "agentis-1.2.7.tar.gz",
            "has_sig": false,
            "md5_digest": "b452d583a808bdd7244b500bb8bb35b1",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<3.13,>=3.8",
            "size": 49720,
            "upload_time": "2024-12-31T18:58:01",
            "upload_time_iso_8601": "2024-12-31T18:58:01.333653Z",
            "url": "https://files.pythonhosted.org/packages/2d/c1/34391649460bed921e9dcbb9eb5579caf9fce7ca2c04d927a2e12ef78f9b/agentis-1.2.7.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-12-31 18:58:01",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Traddoo",
    "github_project": "Agentis-Framework",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "agentis"
}
        
Elapsed time: 0.43725s